API & Integrations

14. API & Integrations

A seção API & Integrations contém ferramentas para integração programática do 7stamp com seus sistemas externos — CRM, POS, ERP, analytics, bots de mensageiros.

API Keys

A página principal da seção é a lista de chaves API. Colunas:

• Name — nome da chave (geralmente corresponde ao nome do Staff vinculado).
• Login — o Staff login ao qual a chave está vinculada.
• API Key — a chave em si (começa com 7loc_sc_..., oculta por padrão, copiável com um clique).
• Status — Active.
• 🔄 — regenerar a chave.
• 🗑️ — excluir a chave.

Criar uma API key

Toque em + ADD API KEY — o popup Generate API Key abre:

• Scanner — dropdown para escolher o Staff Login ao qual a chave será vinculada (um Staff pode ter uma chave).
• Botões CANCEL / GENERATE.

Depois de GENERATE, a chave é criada e aparece na lista. Copie-a imediatamente — a chave completa pode não ser mostrada novamente.

O que você pode fazer via API

• Emitir um cartão para um cliente por email/telefone.
• Adicionar um stamp a um cliente específico.
• Emitir um voucher (por template ou customizado, com Redeem Code).
• Resgatar um voucher (se você trabalha via seu próprio POS).
• Ler o estado do cartão, progresso, histórico.
• Assinar Webhooks para receber eventos em tempo real.

Webhooks

Webhooks enviam eventos de cartão para um sistema externo. Suportados (veja o glossário de eventos):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (com o resultado).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Exemplo de payload de Webhook

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

Integrações POS prontas

• Poster — integração pronta, conecta em poucos cliques.
• Serve — integração pronta.
• Other tills — feitas sob solicitação. Grátis se tecnicamente viável (ou seja, se seu caixa expõe uma API aberta ou Webhooks).

Broadcasts em mensageiros via 7loc.com

Para broadcasts em WhatsApp, Telegram, Viber, a integração 7loc.com é conectada. Quando ativa, o canal “messengers” fica disponível em Campaigns ao lado de PUSH e Email.

Cenários no-code: Zapier e Make

7stamp API + Webhooks funcionam com Zapier e Make (Integromat), permitindo criar cenários sem código:

• “When voucher_redeemed — add a tag in Mailchimp”.
• “When goal_reached — send a notification to Slack”.
• “When birthday_reached — create a task in CRM”.

---