Crie um cartão após um novo contato CRM
Use o contato CRM ID como External ID, crie um convite de cartão 7stamp e envie a instalação devolvida URL através do seu e-mail habitual, SMS, ou etapa de mensagens.
Guia de automação sem código
Conecte 7stamp a Make — passo a passo
Guia de implementaçãoUse Make para conectar 7stamp com um CRM, POS, loja online, planilha, ferramenta de mensagens ou qualquer sistema que possa enviar dados para um cenário. A rota pronta para produção hoje é o aplicativo HTTP do Make para chamadas 7stamp API e o Custom webhook do Make para eventos 7stamp recebidos.
Ainda não há nenhum aplicativo 7stamp público no seletor de aplicativos de Make. Não espere por um: adicione HTTP → Make a request, use o URL exato, método, cabeçalho Bearer e JSON abaixo e mapeie os campos do seu módulo de origem. Este é o mesmo 7stamp Integration API que um conector futuro usaria.
Escolha o primeiro cenário que corresponda ao seu fluxo de trabalho
Comece com um evento e um resultado. Assim que os dados de teste estiverem corretos, adicione filtros, roteadores, atualizações CRM e mensagens de acompanhamento em torno deles.
Adicione selos após um pedido pago
Acione o cenário a partir de um pedido pago POS ou de comércio eletrônico. Mapeie seu cliente estável ID e solicite ID em Digitalizar um cartão e, em seguida, use um valor ou contagem explícita de carimbos.
Envie um acompanhamento de recompensa
Quando um evento de cartão relatar uma recompensa ou voucher, ramifique o cenário: atualize o CRM, notifique a equipe e envie um push de cartão de carteira ou e-mail somente quando necessário.
Lidar com um sistema sem um aplicativo Make nativo
Use o módulo HTTP de Make para chamar 7stamp diretamente. Esta é a escolha universal para um mecanismo de reserva personalizado POS, ERP ou qualquer serviço API-first.
7stamp operações para chamar de Make HTTP
Para cada cartão abaixo, adicione HTTP → Make a request e defina o método e URL exatamente como mostrado. Use a mesma chave Bearer para cada solicitação. O mapeamento necessário informa o que fornecer do gatilho CRM, POS ou de comércio eletrônico.
Make gatilho
Webhooks → Custom webhook Receba um evento de cartão
Crie um Custom webhook em Make, copie seu URL e cole esse URL nas configurações do webhook do perfil 7stamp. Isso inicia um cenário quando 7stamp envia um evento como SCAN, REWARD_EARNED ou VOUCHER_ISSUED.
- Em Make
- Webhooks → Custom webhook → Adicionar; dê a ele um nome claro e copie o URL gerado.
- Em 7stamp
- Admin → API & Integrations → Webhooks; cole URL, selecione os tipos de eventos, salve e crie um evento de teste.
HTTP
POST /cards/invite Crie uma ação Card Invite
Cria uma nova instalação pessoal URL e um código de inserção de entrega para um contato externo.
- Obrigatório
- external_id — mapeie seu estábulo CRM/contact ID, não um nome.
- Em seguida, use
- Mapa install_url da resposta em seu e-mail, SMS ou CRM etapa de atualização.
HTTP ação
POST /cards/invite/bulk Criação em massa Card Invites
Cria até 100 links de convite em uma solicitação. Use-o para uma migração ou campanha controlada, não para uma exportação ilimitada de contatos.
- Itens
- necessários — uma matriz JSON de 1 a 100 objetos de solicitação de convite individuais.
- Verifique
- Leia success_count, error_count e cada resultado antes de enviar qualquer link.
HTTP ação
GET /cards Find Cards
Encontra registros de cartão por External ID, com modelos opcionais e filtros de origem.
- Obrigatório
- Parâmetro de consulta external_id.
- Opcional
- external_source e template_id restringem a pesquisa quando um sistema tem vários programas.
HTTP ação
GET /cards/{user_card_id} Obtenha os detalhes do cartão
Lê o estado completo de um cartão quando uma etapa anterior retornou seu User Card ID interno.
- Obrigatório
- Substitua {user_card_id} pelo ID interno retornado por uma resposta 7stamp confiável.
- Evite
- Não adivinhe ou guarde um cartão ID de um perfil diferente.
HTTP ação
POST /cards/scan Digitalizar um cartão
Adiciona selos de um valor de compra ou de uma contagem explícita. Aceita User Card ID ou External ID e pode manter a referência do pedido externo.
- Identidade
- Use external_id e opcional external_source; user_card_id ganha se ambos forem fornecidos.
- Compra
- Use o valor para cartões baseados em valor ou stamps_count para um número explícito; stamps_count tem prioridade.
- Rastreabilidade
- Mapeie external_order_id do pedido pago/receipt para que os eventos 7stamp possam ser correspondidos.
HTTP ação
GET /templates List Templates
Lista os modelos de cartão disponíveis para a chave API. Use-o para testar a conexão ou para selecionar um modelo dinamicamente.
- Primeiro teste
- Esta é a primeira solicitação mais segura: não possui corpo e não altera os dados do cliente.
- Mapear posteriormente
- Use um ID de modelo ativo como template_id somente quando o perfil tiver mais de um modelo ativo.
HTTP ação
GET /templates/{template_id}/design Get Template Design
Retorna as configurações de design visual para um modelo conhecido, útil quando outro sistema precisa exibir uma escolha de cartão consistente.
HTTP ação
POST /vouchers/issue Emitir um voucher
Emite um voucher para um titular de cartão identificado por External ID ou User Card ID.
- Obrigatório
- comprovante.short_description. Mire no cartão com external_id ou um user_card_id conhecido.
- Validade
- Use validity_type com validity_value ou leia a referência OpenAPI para uma data de validade fixa.
HTTP ação
POST /messages/send Enviar uma mensagem
Envia conteúdo ao titular do cartão por meio de envio de cartão de carteira e e-mail /or, sujeito ao canal configurado e às regras de consentimento.
- Cartão push
- card_push_text é limitado a 20 caracteres e requer um passe de carteira instalado.
- Enviar assunto mais corpo; básico HTML é suportado no corpo.
Make módulo
Full 7stamp endpoint URL HTTP → Make a request
Este é o módulo Make que chama todas as rotas 7stamp acima. Use um URL completo, selecione o método documentado, adicione o cabeçalho Bearer e use JSON somente quando a rota precisar de um corpo.
- Base URL
- https://api.7loc.com/cards-api
- Cabeçalho
- Authorization: Bearer YOUR_7STAMP_API_KEY; Content-Type: application/json para solicitações POST.
Três cenários Make que você pode construir exatamente como está escrito
Os nomes abaixo são os módulos Make reais. Comece com o primeiro cenário, execute-o em um contato descartável e só então adicione roteadores, filtros ou agendamento de produção.
1. Novo contato CRM → enviar link do cartão 7stamp
Resultado esperado: O cliente recebe o install_url devolvido por 7stamp; seu CRM pode manter esse URL no mesmo registro de contato.
- 1 Crie um cenário e adicione o gatilho de contato novo/Created do seu CRM. Para Kommo, escolha o gatilho de criação de contato e execute-o uma vez para carregar um contato de amostra.
- 2 Adicione HTTP → Make a request. Defina o método como POST e URL como https://api.7loc.com/cards-api/cards/invite.
- 3 Adicione Authorization: Bearer YOUR_7STAMP_API_KEY e Content-Type: application/json. No corpo JSON, mapeie o contato CRM ID em external_id e defina external_source para um rótulo fixo como kommo.
- 4 Execute o módulo HTTP uma vez. Confirme se a saída tem install_url, delivery_insert_code, external_id e template_id.
- 5 Adicione seu módulo de atualização email/SMS/CRM após HTTP e mapeie install_url da saída HTTP. Salve o URL no contato CRM se a equipe precisar reenviá-lo mais tarde.
Verifique: POST /cards/invite sempre cria um novo convite. Use Find Cards primeiro se sua regra de negócios for evitar outro convite para um contato existente.
2. Pedido pago → adicionar selos de fidelidade
Resultado esperado: Uma resposta de digitalização bem-sucedida inclui sucesso, scan_id, stamps_added e o estado do cartão pós-digitalização para sua próxima etapa.
- 1 Comece no gatilho POS/ecommerce Pedido Pago. Make certifique-se de que sua amostra contém um cliente estável ID e o pedido/receipt ID.
- 2 Adicione HTTP → Make a request com POST https://api.7loc.com/cards-api/cards/scan e o mesmo cabeçalho Bearer.
- 3 Mapa external_id do cliente, external_source do nome do sistema e external_order_id do pedido ID. Adicione o valor para cartões baseados em valor ou stamps_count para um número explícito de selos.
- 4 Run once com pedido de teste. Verifique o sinalizador de sucesso retornado e stamps_added antes de ativar o agendamento do cenário.
- 5 Opcionalmente, adicione um filtro após a etapa HTTP: continue somente quando o sucesso for verdadeiro e, em seguida, escreva scan_id ou stamps_added de volta ao registro order/CRM.
Verifique: Use o mesmo external_order_id em novas tentativas para que o pedido possa ser rastreado em eventos de webhook posteriores; não conceda selos duas vezes após uma execução fracassada e pouco clara.
3. Evento 7stamp → atualiza o evento CRM
Resultado esperado: Make recebe o evento 7stamp imediatamente e pode encontrar o registro CRM correspondente via external_id e external_source.
- 1 Crie um cenário Make separado. Adicione Webhooks → Custom webhook, selecione Adicionar, nomeie-o 7stamp-card-events e copie o URL gerado.
- 2 Em 7stamp Admin, abra API & Integrations → Webhooks. Adicione URL e selecione um pequeno conjunto de eventos, por exemplo SCAN e REWARD_EARNED.
- 3 Crie uma verificação de teste descartável ou evento de cartão em 7stamp. Retorne para Make e use Run once para deixar Make determinar a estrutura de dados do evento.
- 4 Adicione uma etapa de pesquisa CRM usando external_id. Adicione um filtro ou roteador em event_type para que SCAN, REWARD_EARNED e VOUCHER_ISSUED possam realizar ações diferentes.
- 5 Adicione a ação CRM update/note. Mapeie scanned_at, stamps_after, external_order_id e issued_vouchers somente quando esses campos estiverem presentes para o tipo de evento selecionado.
Verifique: Mantenha o webhook URL privado. Teste um evento real antes de ativar mensagens irreversíveis, vouchers ou alterações CRM.
Obtenha a chave 7stamp API antes de abrir Make
Estas são as telas 7stamp Admin exatas. Crie a chave uma vez, copie-a para a conexão segura HTTP/keychain do Make e remova-a imediatamente da área de transferência.
Prepare a conexão antes de construir
Crie uma chave API por ambiente
Em 7stamp Admin, vá para API & Integrations → API Keys → Add API Key. Armazene o valor em Make's HTTP API-key connection/keychain quando essa opção estiver disponível. Nunca mapeie a chave de um campo de texto, coloque-a em uma nota ou use-a em um fluxo de trabalho voltado para o navegador. Uma chave pertence a um 7stamp local de trabalho/profile.
Use um estável External ID
Mapeie o imutável ID de seu CRM, POS ou plataforma de comércio - por exemplo, um contato CRM ID ou cliente UUID. Adicione External Source como hubspot, shopify ou poster quando o mesmo identificador puder aparecer em mais de um sistema.
Decida qual modelo se aplica
Quando o perfil 7stamp conectado tiver um modelo de cartão ativo, o Modelo poderá ser deixado em branco. Com vários modelos, mapeie ou escolha template_id deliberadamente para que cada convite e digitalização chegue ao programa de fidelidade pretendido.
Configuração exata de Make HTTP: crie um convite de cartão
Copie isso em sua etapa de automação
http Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Body type: Raw / JSON
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
}Crie e teste seu primeiro cenário Make
Em 7stamp Admin, crie uma chave em API & Integrations → API Keys → Add API Key. Use um perfil de teste separado/key quando a configuração da sua conta permitir.
Em Make, crie um cenário e adicione o gatilho de origem. Execute-o uma vez antes de mapear para que você possa ver uma amostra real de contato ou pedido pago.
Clique no próximo sinal de mais, pesquise HTTP e escolha Make uma solicitação. Defina o método, URL completo e cabeçalhos do cartão de operação nesta página.
Use GET https://api.7loc.com/cards-api/templates como a primeira solicitação. Sua resposta bem-sucedida prova que a chave funciona sem alterar nenhum dado do cliente.
Para rotas POST, selecione application/json e cole o formato do corpo deste guia. Mapeie um estábulo External ID; adicione template_id somente se o perfil tiver vários modelos ativos.
Execute com um contato descartável, inspecione a saída HTTP e só então mapeie seus campos de resposta exatos para o próximo CRM, e-mail ou módulo de mensagens.
Quando você deve usar Make HTTP?
Use HTTP para 7stamp agora: é a rota documentada e pronta para produção, não um substituto reduzido. Escolha-o sempre que precisar de uma operação 7stamp, uma nova rota API ou uma conexão POS/ERP personalizada. A referência OpenAPI é a fonte da verdade para o método, caminho completo, corpo e esquema de resposta; a chave do portador e a base URL permanecem as mesmas.
Receba eventos 7stamp em Make
Para um cenário orientado a eventos, adicione Webhooks → Custom webhook e crie um webhook. Copie seu URL, abra API & Integrations → Webhooks no perfil 7stamp, cole URL, selecione os tipos de evento, salve e envie um evento de teste real. O perfil 7stamp possui essa assinatura; o API atual não expõe endpoints automáticos de assinatura do webhook/unsubscribe.
Nenhum conector Make público é necessário
As instruções nesta página usam módulos Make que estão disponíveis para todas as contas Make. Se você deseja um futuro módulo nativo 7stamp em vez de HTTP, envie-nos o fluxo de trabalho necessário; até então, HTTP e Custom webhooks cobrem todas as operações 7stamp documentadas.
Perguntas frequentes
Não consigo encontrar 7stamp em Make. Ainda posso automatizá-lo?
Sim. Não há nenhum aplicativo 7stamp público em Make hoje. Adicione HTTP > Make uma solicitação, use o endpoint 7stamp completo URL e envie Authorization: Bearer seguido por sua chave 7stamp API. HTTP pode chamar todos os endpoints documentados.
Onde posso obter o token para a conexão Make?
Em 7stamp Admin, abra API Integrações, depois API Keys e depois Add API Key. A chave tem como escopo o local de trabalho/profile que a criou, portanto, use um perfil de teste para cenários de teste sempre que possível.
Qual identificador devo mapear como External ID?
Use o identificador estável do sistema de origem, de preferência um contato CRM ID ou cliente UUID. Não use um nome de exibição. Um número de telefone ou e-mail pode funcionar, mas pode mudar e deve ser tratado de forma consistente.
Como faço para inserir eventos 7stamp em Make?
Crie um Webhooks > Custom webhook em Make e cole o URL gerado nas configurações do webhook do perfil 7stamp. Use um filtro ou roteador Make após a entrega para lidar com o event_type recebido.
Próxima etapa
Pronto para automatizar a primeira ação de fidelidade?
Crie a chave API, teste List Templates e crie um convite ou cenário de digitalização com um contato descartável. Adicione roteadores e mensagens somente depois que o fluxo simples for confiável.