Integração do desenvolvedor
Envie todos os eventos de fidelidade de 7stamp para seus próprios sistemas em tempo real. Sem votação e sem chamadas agendadas para API. Os eventos chegam como solicitações HTTPS POST segundos após acontecerem.
Use webhooks para manter seu CRM, ERP ou back-end personalizado sincronizado com o que está acontecendo no lado da fidelidade: quem se inscreveu, quem recebeu um carimbo, quem resgatou um voucher, quem acionou um presente de aniversário e quem ficou inativo. Então seus sistemas decidem o que fazer com esses dados.
Webhooks são o lado de saída da pilha de integração. Eles refletem a atividade de clientes e recompensas nos sistemas em que você já confia para vendas, serviços, análises e mensagens.
Cada carimbo, voucher, aniversário e gatilho de inatividade vão para o registro do cliente em seu CRM. Você vê o cronograma completo de fidelidade ao lado de vendas, ligações e ingressos sem fazer login em 7stamp.
Quando um cliente resgata um voucher, envie um agradecimento SMS do seu gateway SMS existente. Quando um cliente atingir a meta, poste uma comemoração em Slack. Quando alguém ficar inativo, encaminhe o caso para o seu gerente de conta.
Transmita eventos para sua ferramenta BI, armazém ou pipeline de reconciliação. Combine os resgates de vouchers com os recibos de POS e calcule a fidelidade ROI em suas próprias métricas.
Seu endpoint deve aceitar HTTPS POST, valide o formato da solicitação, persista ou coloque o evento na fila e retorne uma resposta 2xx bem-sucedida. Não faça uma chamada lenta CRM ou de mensagens antes da confirmação se puder ser colocada na fila com segurança.
Cada evento relacionado pode conter o External ID e o External Source opcional que você usou ao criar ou digitalizar o cartão. Use este par para atualizar seu próprio CRM, POS ou registro de pedido sem adivinhar por nome ou e-mail.
Armazene uma chave de processamento durável ou impressão digital de evento antes de desencadear efeitos colaterais. Se o seu destinatário vir a mesma entrega novamente, ele não deverá adicionar uma nota, voucher ou mensagem CRM duplicada. Trate o endpoint URL como um segredo.
json {
"event_type": "SCAN",
"scanned_at": "2026-07-23T12:34:56Z",
"user_card_id": 123,
"card_template_id": 42,
"card_template_name": "Coffee Loyalty",
"stamps_added": 1,
"stamps_before": 4,
"stamps_after": 5,
"amount": 24.5,
"external_order_id": "order_2048",
"external_id": "crm_contact_8821",
"external_source": "hubspot"
}Crie um endpoint HTTPS em seu back-end, CRM camada de integração, Make webhook ou Zapier Catch Hook. Make certifique-se de controlar o destino antes de copiar seu URL.
Em 7stamp Admin, abra Stamp Cards → API & Integrations → Webhooks.
Adicione o endpoint URL e selecione apenas os tipos de eventos que o fluxo de trabalho de recebimento realmente precisa.
Salve as configurações do perfil e acione uma varredura de teste descartável ou ação de cartão para produzir um evento.
Inspecione a carga recebida. Combine External ID e External Source com o registro esperado e confirme se o receptor retorna uma resposta bem-sucedida.
Habilite CRM, voucher ou efeitos colaterais de mensagens somente depois de ter manipulação segura de reprodução e monitoramento de falhas.
Em Make, use Webhooks → Custom webhook para gerar um URL de recebimento e cole-o em 7stamp perfil. Em Zapier, use Webhooks by Zapier → Catch Hook para a mesma finalidade. O perfil 7stamp possui a assinatura porque o API atual não expõe endpoints de registro automático de webhook.
Use a seção Webhooks da referência pública OpenAPI como fonte para o esquema de carga útil atual e o significado do campo. Exija HTTPS, mantenha o receptor URL fora dos logs públicos e torne o processamento idempotente. Confirme o procedimento de solicitação de autenticação/signature para seu perfil 7stamp durante a integração antes de impor um nome de cabeçalho específico ou uma política de nova tentativa na produção.
Sim. Selecione os tipos de eventos nas configurações de webhook do perfil 7stamp para que o receptor obtenha apenas os eventos que importam para seu fluxo de trabalho.
Crie o webhook de recebimento em Make ou um Catch Hook em Zapier, copie o URL gerado, cole-o nas configurações do webhook do perfil 7stamp e envie um evento de teste.
Use External ID e, quando presente, External Source. Estes são os identificadores fornecidos pela sua integração quando o cartão foi criado ou digitalizado.
Não. Use o contrato de entrega OpenAPI/profile atual e confirme o procedimento de autenticação para seu perfil durante a integração antes de codificar um cabeçalho ou tentar novamente.
Páginas relacionadas
Próxima etapa
Crie um receptor, cole seu HTTPS URL no perfil, execute uma varredura descartável e valide o External ID correspondente antes de ativar a automação downstream.