Crie um convite de um contato CRM
Acione um contato novo ou qualificado, mapeie seu CRM ID para External ID, crie um convite de cartão e passe a instalação retornada URL para um e-mail ou passo SMS.
Guia de automação sem código
Conecte 7stamp a Zapier — passo a passo
Guia de implementaçãoUse Zapier quando seu fluxo de trabalho for uma sequência clara: um contato ou pedido aparece, 7stamp executa uma ação e outra ferramenta de negócios é atualizada. A rota segura hoje é API por Zapier para chamadas 7stamp API de saída e Webhooks by Zapier → Catch Hook para eventos 7stamp de entrada.
Não há aplicativo 7stamp público no mercado de Zapier. Use API by Zapier → API Request quando disponível: ele armazena uma chave estática API na conexão do aplicativo em vez de expô-la em uma etapa Zap. Use Webhooks by Zapier apenas para eventos Catch Hook recebidos; não coloque uma chave 7stamp Bearer em um campo de ação visível do Webhooks.
Comece com um Zap linear e testável
Mantenha o primeiro Zap pequeno. Um fluxo confiável de contato para cartão ou pedido pago para selos é um ponto de partida melhor do que uma ampla sincronização CRM bidirecional.
Adicione carimbos após finalizar a compra
Acione a partir do pedido pago ou recibo fechado, mapeie a identidade do cliente e o pedido ID, depois use Scan Card com o valor do pedido ou número explícito de carimbos.
Emitir um voucher de recuperação único
Use uma regra CRM, evento de suporte ou exportação de segmento para identificar um cliente, emitir um voucher para seu cartão e enviar uma mensagem de acompanhamento do canal correto.
Escreva eventos de cartão em seu CRM
Use Webhooks by Zapier > Catch Hook para receber eventos de cartão 7stamp. Combine o External ID retornado com o registro CRM e adicione a nota, tag ou tarefa relevante.
7stamp operações para chamar de API por Zapier
Adicionar API by Zapier → API Request após o seu gatilho. Crie uma conexão de chave 7stamp API e selecione o método exato e URL completo abaixo. Cada operação retorna campos que você pode mapear para a próxima etapa do Zap.
API por Zapier ação
POST /cards/invite Criar Card Invite
Cria uma nova instalação de cartão de carteira URL e código de inserção de entrega para um contato externo.
- Obrigatório
- external_id do gatilho CRM/contact.
- Próxima etapa
- Mapeie install_url para email, SMS ou um campo CRM.
API por ação Zapier
POST /cards/invite/bulk Criação em massa Card Invites
Cria até 100 links de convite de um lote JSON controlado.
- Matriz de itens
- obrigatórios com 1 a 100 objetos de convite.
- Verifique
- Leia success_count, error_count e todos os resultados antes da entrega.
API por Zapier ação
POST /cards/scan Scan Card
Adiciona selos por User Card ID ou External ID, com valor, contagem de selos, pedido ID e dados de recibo opcionais.
- Identidade
- external_id mais opcional external_source; user_card_id vence se ambos estiverem presentes.
- A regra do selo
- stamps_count tem prioridade sobre o valor.
API por Zapier ação
POST /vouchers/issue Issue Voucher
Emite um voucher diretamente ao titular do cartão.
- Voucher
- obrigatório.short_description e um alvo external_id ou conhecido user_card_id.
- Resultado
- Mapear unique_code, status ou expires_at para uma nota ou mensagem CRM.
API por Zapier ação
POST /messages/send Send Message
Envia push de cartão de carteira e conteúdo de e-mail /or para o proprietário do cartão.
- Cartão push
- card_push_text é limitado a 20 caracteres.
- assunto mais corpo; o resultado informa se a entrega estava na fila.
API por Zapier ação
GET /cards Find Cards
Encontra registros de cartão por External ID, com filtros opcionais de origem e modelo.
- Obrigatório
- external_id como parâmetro de consulta.
- Use primeiro
- Use antes de criar um convite quando sua regra evitar convites duplicados.
API por Zapier ação
GET /cards/{user_card_id} Obter detalhes do cartão
Lê o estado de um cartão por seu 7stamp interno ID.
- Obrigatório
- Substitua {user_card_id} por um ID retornado por 7stamp.
- Saída útil
- stamps_count, estado da carteira e active_vouchers_count.
API por Zapier ação
GET /templates List Templates
Lista modelos disponíveis para o perfil conectado e verifica a conexão API.
- Primeiro teste
- Chame-o antes de qualquer ação de gravação: não altera os dados do cliente.
- Usar mais tarde
- Um ID ativo se torna template_id quando existem vários modelos.
API por Zapier ação
GET /templates/{template_id}/design Get Template Design
Recupera as configurações de design de um modelo para um modelo conhecido ID.
Zapier gatilho
Webhooks by Zapier → Catch Hook Receber eventos de cartão
Catch Hook dá a Zapier um HTTPS URL exclusivo. Cole-o nas configurações do webhook de 7stamp Admin e teste-o com um evento de cartão real.
- Em Zapier
- Use Catch Hook para dados de eventos analisados; use Catch Raw Hook somente quando você também precisar de cabeçalhos de solicitação brutos/body.
- Correspondência
- Encontre o contato CRM usando external_id e opcional external_source do evento.
Três fluxos de trabalho Zapier que você pode criar passo a passo
Cada cenário usa um módulo Zapier real, atualmente disponível. Crie primeiro uma pequena rota e teste-a com um contato descartável antes de ligar o Zap.
1. Contato CRM qualificado → emitir um cartão
Resultado esperado: O próximo passo do Zap recebe install_url e pode enviar para o cliente ou escrever de volta no registro CRM.
- 1 Crie um Zap e selecione o evento CRM que significa que um contato é elegível para fidelidade. Teste o gatilho e confirme que você possui o ID imutável do contato.
- 2 Adicione API by Zapier → API Request. Crie ou selecione a conexão de chave 7stamp API, escolha POST e defina URL como https://api.7loc.com/cards-api/cards/invite.
- 3 Defina o corpo como JSON. Mapeie CRM ID em external_id, defina um external_source fixo como kommo e adicione template_id somente quando mais de um modelo 7stamp estiver ativo.
- 4 Teste a ação. Confirme se a resposta contém install_url e delivery_insert_code para o mesmo external_id.
- 5 Adicione sua atualização CRM, e-mail ou ação SMS. Mapa install_url da resposta API; não codifique ou copie um teste URL.
Verifique: Criar Card Invite sempre retorna um novo convite. Adicione uma solicitação Find Cards ou um filtro Zapier primeiro se sua política for um convite por contato.
2. Pedido pago → selos de prêmio
Resultado esperado: O pedido cria uma varredura 7stamp rastreável e o Zap pode registrar stamps_added ou scan_id no sistema de origem.
- 1 Use um pedido pago/Closed Gatilho de recebimento e teste-o. Confirme se o cliente ID e o pedido exclusivo ID estão presentes antes de continuar.
- 2 Adicione API by Zapier → API Request com POST https://api.7loc.com/cards-api/cards/scan e selecione a mesma conexão 7stamp.
- 3 Envie JSON com external_id, external_source, external_order_id e o valor para modelos baseados em valor ou stamps_count para um prêmio de selo explícito.
- 4 Teste com um pedido descartável. Inspecione o sucesso, scan_id e stamps_added na resposta.
- 5 Adicione um filtro que continue somente após uma resposta bem-sucedida e atualize o pedido/CRM com o resultado confirmado.
Verifique: Se o Zap for reproduzido novamente, verifique a ordem original antes de enviar outro scan. Mantenha external_order_id estável para que o evento possa ser reconciliado posteriormente.
3. Evento 7stamp → crie uma nota ou tarefa CRM
Resultado esperado: Zapier recebe um evento 7stamp analisado, encontra o cliente por external_id e cria o acompanhamento apropriado.
- 1 Crie um novo Zap com Webhooks by Zapier como gatilho. Selecione Catch Hook, continue e copie o URL exclusivo mostrado na etapa de teste.
- 2 Em 7stamp Admin, abra API & Integrations → Webhooks, adicione Catch Hook URL, selecione apenas os tipos de eventos necessários e salve.
- 3 Causa uma verificação de teste real ou um evento de cartão. De volta a Zapier, clique em Test trigger e confirme que event_type, external_id e external_source chegam como campos de amostra.
- 4 Adicione uma ação CRM Encontrar contato usando external_id. Adicione uma regra de Filtro ou Caminhos para event_type, por exemplo, separe SCAN de REWARD_EARNED.
- 5 Crie uma nota CRM/task e mapeie apenas os campos que existem para esse evento, como scanned_at, stamps_after, external_order_id ou issued_vouchers.
Verifique: Um Catch Hook URL é um segredo. Se o Zap for transferido para outro proprietário, atualize URL em 7stamp Admin antes de confiar nele.
Crie a chave 7stamp API antes de construir o Zap
Estas são as etapas do lado 7stamp. Faça isso uma vez e use a chave somente dentro da conexão API por Zapier - não em um campo de ação Webhooks by Zapier ou em uma nota.
Regras de conexão que evitam incompatibilidades de dados
Mantenha a chave API em uma conexão API por Zapier
Em 7stamp Admin, escolha API & Integrations → API Keys → Add API Key. Em API por Zapier, crie uma conexão de chave API com um cabeçalho Authorization estático contendo Bearer seguido por essa chave. API por Zapier mantém a credencial na conexão em vez de uma etapa Zap visível; restringir o acesso à conexão e girar a chave se ela estiver exposta.
Mapa External ID e External Source consistentemente
External ID é o seu próprio identificador de cliente estável; External Source rótulos de onde veio, por exemplo, hubspot, bitrix24, shopify ou poster. Use o mesmo par para fluxos de criação, localização, digitalização, voucher e webhook.
Saiba qual identificador de cartão ganha
As ações de direcionamento de cartão aceitam User Card ID ou External ID. Quando ambos estão presentes, User Card ID tem prioridade. Use o ID interno somente depois de ter sido retornado por uma etapa 7stamp confiável; caso contrário, prefira o sistema de origem External ID.
Exato API por Zapier solicitação: conceda um selo
Copie isso em sua etapa de automação
http Method: POST
URL: https://api.7loc.com/cards-api/cards/scan
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Data:
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"stamps_count": 1,
"external_order_id": "order_2048"
}Construa seu primeiro Zap
Crie uma chave 7stamp API no Admin: API & Integrations → API Keys → Add API Key. Use uma chave de teste separada/profile quando disponível.
Em Zapier, crie um Zap e teste o gatilho de origem. Use uma amostra real para que o contato ID, cliente ID, pedido ID e valor estejam disponíveis para mapeamento.
Adicionar API by Zapier → API Request. Crie uma conexão 7stamp para o cabeçalho estático Bearer Authorization em vez de colocar o segredo em um campo de ação Webhooks by Zapier.
Ligue para GET https://api.7loc.com/cards-api/templates primeiro. Isso confirma o funcionamento principal e mostra quais IDs de modelos ativos estão disponíveis sem modificar os dados do cliente.
Selecione POST /cards/invite ou POST /cards/scan, defina JSON como o tipo de corpo e mapeie o External ID estável mais os campos de modelo relevantes/order do gatilho.
Execute a ação com um contato descartável, inspecione seus campos de resposta exatos e, em seguida, mapeie esses campos para a próxima etapa CRM, e-mail ou mensagem antes de publicar o Zap.
Use a solicitação universal apenas para rotas documentadas
Use API por Zapier para uma solicitação 7stamp com uma chave Bearer API: mantém chaves de cabeçalho estáticas em uma conexão de aplicativo. Use Webhooks by Zapier para entrega de eventos Catch Hook, não como local preferido para um segredo 7stamp. Mantenha a base URL em https://api.7loc.com/cards-api,, use a referência pública OpenAPI para esquemas exatos e nunca envie credenciais ou dados do cliente para um URL não verificado.
Receba eventos 7stamp por meio de Catch Hook
Crie Webhooks by Zapier → Catch Hook, copie o URL exclusivo mostrado na configuração do teste, cole-o nas configurações de webhook do perfil 7stamp, selecione os tipos de eventos, e, em seguida, envie uma verificação de teste real ou um evento de cartão. Use External ID e External Source da carga útil do evento para localizar o contato CRM correto. Escolha Catch Raw Hook somente quando precisar especificamente do corpo não analisado e dos cabeçalhos de solicitação.
Use a rota segura Zapier agora
API por Zapier e Catch Hook são suficientes para todas as operações públicas 7stamp API e eventos de cartão. Se você precisar de um futuro aplicativo nativo 7stamp Zapier, envie-nos a ação exata/trigger que sua equipe mais usa.
Perguntas frequentes
Onde posso encontrar o aplicativo 7stamp em Zapier?
Não há aplicativo de mercado 7stamp público hoje. Use API by Zapier → API Request para chamadas 7stamp API e Webhooks by Zapier → Catch Hook para eventos 7stamp recebidos.
Onde posso criar o token Zapier?
Crie uma chave 7stamp API em Admin em API & Integrations → API Keys → Add API Key. Armazene-o como um cabeçalho estático Bearer Authorization na conexão API por Zapier, não em um campo de ação Webhooks by Zapier visível.
Como posso Zapier receber um selo ou voucher de evento?
Crie um Catch Hook em Webhooks by Zapier, cole o URL gerado nas configurações do webhook do perfil 7stamp, selecione os eventos e envie um evento de teste antes de ativar as atualizações CRM.
Devo escolher Zapier ou Make?
Escolha Zapier para um fluxo de trabalho de ação de gatilho principalmente linear. Escolha Make quando precisar de roteadores, transformações complexas ou cenários longos com várias filiais. Ambos usam a mesma chave 7stamp API e pontos de extremidade.
Próxima etapa
Construa o primeiro Zap com um contato de teste
Crie a chave API, teste GET /templates até API por Zapier e, em seguida, crie uma ação de contato para cartão ou pedido para selos. Adicione Catch Hook assim que o fluxo de saída tiver um resultado de teste comprovado.