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 {
"entity": "card_event",
"action": "created",
"entity_id": 707,
"event_id": "8f05e58decec48e09d328f0edebbacf6",
"profile_id": 2,
"profile_name": "Your Business",
"profile_lang": "en",
"data": {
"event_type": "SCAN",
"scanned_at": "2026-10-01T09:19:24.179424",
"user_card_id": 10,
"card_template_id": 14,
"card_template_name": "Collect your stamps!",
"stamps_added": 3,
"stamps_before": 1,
"stamps_after": 4,
"amount": null,
"external_order_id": "ORDER-1001",
"workplace": { "id": 4, "name": "Bar Counter" },
"device_type": null,
"external_id": "odoo_contact_8821",
"external_source": "odoo",
"issued_vouchers": [
{
"id": 174,
"unique_code": "100425813507",
"stamp_number": 4,
"issued_at": "2026-10-01T09:19:24.191836",
"expires_at": "2027-01-01T23:59:59",
"status": "ACTIVE",
"voucher_template_id": 58,
"voucher_description": "Free coffee",
"voucher_image_url": "https://..."
}
],
"achieved_goals": [],
"user": {
"id": 2,
"name": "Anna",
"full_name": "Anna Smith",
"email": "anna@example.com",
"telegram_chat_id": null,
"telegram_username": null,
"whatsapp_phone": null,
"birth_date": null
}
}
}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 a URL do endpoint. O webhook recebe todos os eventos de cartão do perfil, então filtre por data.event_type no seu receptor.
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 do esquema atual do payload. O corpo é um envelope: profile_id e profile_name indicam o perfil 7Stamp, event_id identifica o evento e o próprio evento de cartão fica em data (para uma URL do Make ou do Zapier, a chave é card_event). Cada entrega é assinada em um único cabeçalho, X-Webhook-Signature: t=…,s=…. Calcule o HMAC-SHA256 com o segredo do seu webhook sobre t mais o corpo bruto da requisição, codifique-o em hexadecimal e compare-o com s; o segredo fica na página do webhook no 7Stamp Admin. Use X-Webhook-Event-Id para descartar entregas repetidas: uma nova tentativa é assinada novamente com um novo t. Você também pode proteger o endpoint com Basic Auth. Exija HTTPS e mantenha a URL do receptor fora de logs públicos.
Não. Um webhook do 7Stamp recebe todos os eventos de cartão do perfil. Filtre por data.event_type no seu receptor; no Make e no Zapier, o evento vem dentro de card_event, então filtre por card_event.event_type.
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 data.external_id e, quando presente, data.external_source: eles voltam em todo webhook de cartões que você emitiu pela API com o seu próprio ID. Um cliente que pegou o cartão por conta própria não tem External ID, então identifique-o por data.user.email. Um endereço “Hide My Email” da Apple é um endereço de retransmissão, não o que está no seu CRM.
Divida o cabeçalho X-Webhook-Signature em t e s, calcule o HMAC-SHA256 com o segredo do webhook do 7Stamp Admin sobre t mais o corpo bruto da requisição, codifique-o em hexadecimal e compare-o com s. Use t exatamente como foi enviado e o corpo como os bytes brutos recebidos, antes de qualquer análise do JSON. Descarte uma entrega cujo X-Webhook-Event-Id você já processou: uma nova tentativa é assinada novamente com um novo t.
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.