Receber dados de outro sistema por webhook
Crie ou atualize Contatos automaticamente quando outro sistema enviar dados ao Zapei.
Um webhook é um endereço que outro sistema usa para avisar o Zapei de que algo aconteceu: uma compra aprovada, um formulário preenchido ou um cadastro novo. Quando o aviso chega, o Zapei cria ou atualiza o Contato e executa as ações que você definir.
Antes de começar
Você precisa ter acesso ao sistema que vai enviar os dados, como a plataforma de vendas ou o construtor de formulários, para colar o endereço do Zapei nele.
Passo a passo
- No menu lateral, clique em Automações e abra a aba Webhooks.
- Selecione Entrada e clique em Novo webhook.
- Em Nome, identifique de onde os dados vêm. Exemplo: Vendas Loja Bonavita.
- Em URL de recebimento, clique em Copiar e cole esse endereço no outro sistema, no campo de webhook ou notificação.
- Em Identificar contato por, escolha qual dado o Zapei usa para reconhecer o Contato. Exemplo: Telefone.
- Em Se o contato já existir, escolha o que fazer quando o Contato já estiver cadastrado. Exemplo: Atualizar o contato existente.
- Em Mapeamento de campos, ligue cada informação recebida a um dado do Contato. À esquerda fica o nome do campo que o outro sistema envia. À direita, onde o Zapei guarda essa informação. Para outra linha, clique em Adicionar mapeamento.
- Em Ações, clique em Adicionar ação e escolha o que acontece depois que o Contato é criado ou atualizado. Exemplo: Executar fluxo, com o Fluxo de Conversa de confirmação de compra.
- Clique em Salvar alterações.
Se o outro sistema for conhecido, abra Modelos de integração no mapeamento. O Zapei preenche os campos mais comuns por você.
Mensagens que precisam chegar mesmo durante um Atendimento
Ao escolher Executar fluxo, a opção Permitir disparo transacional (mesmo em atendimento humano) faz o Fluxo de Conversa ser enviado mesmo se o Contato estiver sendo atendido por um membro da equipe.
Use essa opção para mensagens que o Contato precisa receber de qualquer jeito: confirmação de compra, lembrete ou aviso de pagamento. O Atendimento continua com o membro da equipe.
Resultado esperado
O webhook aparece na aba Webhooks com o status Ativo. O cartão mostra quantos dados chegaram no mês, o total desde a criação e a porcentagem de sucesso.
Problemas comuns
O outro sistema parou de enviar depois que gerei um novo token. O botão Novo token cria um endereço novo. Copie a URL de recebimento de novo e atualize no outro sistema.
Quero interromper o recebimento por um tempo. Abra o webhook e clique em Pausar.