Automações

O construtor de automações tem três blocos para falar com sistemas de fora do Zaplin:

Para receber todos os eventos do workspace (toda mensagem, todo contato novo), sem montar automação, use um endpoint de webhook.

Webhook recebidoCopiar link

Explicado em webhooks de entrada: a automação ganha uma URL própria, e cada evento aceito nela inicia uma execução.

Requisição HTTPCopiar link

Exemplo: quando um lead agenda a demonstração, criar o negócio no seu CRM.

1. Adicione o bloco Requisição HTTP depois do passo que tem os dados.
2. Escolha o Método e cole a URL.
3. Em Cabeçalhos, adicione o que a sua API pede, como Authorization.
4. Em Corpo (JSON), escreva o JSON usando variáveis do fluxo:

{
  "nome": "{{trigger.contact.name}}",
  "telefone": "{{trigger.contact.phone}}",
  "origem": "zaplin"
}

Os próximos blocos leem a resposta em {{http_1.response.status}} e {{http_1.response.body}}. Por exemplo, uma Condição pode seguir por caminhos diferentes conforme o status.

Se der errado: em Repetir em falha, o Zaplin tenta mais 2 vezes, com espera crescente, quando a sua API não responde em 10 segundos ou devolve um erro 5xx. Um 4xx não é repetido, porque tentar de novo não muda a resposta. Depois disso, o fluxo segue pela saída de erro do bloco, se você ligou uma; senão, a execução para e aparece como falha em Execuções.

Enviar webhookCopiar link

Exemplo: quando o agente de IA marca uma demonstração, avisar o seu sistema.

1. Adicione o bloco Enviar webhook e cole a URL que vai receber.
2. Deixe o Corpo (JSON) vazio para mandar o padrão, ou escreva o seu, como na Requisição HTTP.
3. Clique em Gerar segredo e guarde o whsec_… no seu servidor: ele só é mostrado uma vez.

Com o corpo vazio, o seu servidor recebe o que o gatilho trouxe e o contato da execução:

{
  "trigger": {
    "message": { "text": "Pode ser amanhã às 10h?" },
    "contact": { "name": "Carlos Pereira" }
  },
  "contact": {
    "id": "3b0f6c1e-…",
    "name": "Carlos Pereira",
    "phone": "+5511988881020",
    "email": null
  }
}

Com um segredo, cada envio vem assinado do mesmo jeito que as entregas de webhook: confira com a biblioteca oficial standardwebhooks, com o mesmo código. Se a sua URL falhar, o Zaplin repete como na Requisição HTTP, com o mesmo webhook-id, e você usa ele para ignorar repetidos.

Testar sem chamar ninguémCopiar link

O Testar do construtor simula esses blocos: nada sai de verdade. Para ver a chamada de verdade, ative a automação e acompanhe em Execuções, onde cada passo mostra o que saiu e o que voltou.