Aparência

Modificar os dados enviados pelo webhook ​

Por padrão, o webhook envia os dados de cada evento num formato fixo da Zeeps. Se o sistema de destino (um CRM, uma ferramenta de BI ou de automação) espera outro formato, use os Modificadores de dados: você escreve um modelo e a Zeeps monta o envio a partir dele.

Aba Modificadores de dados com um campo de modificador por evento

Como o modelo funciona ​

  • Valores fixos: o que você escreve vai do jeito que está.
  • Valores do evento: escreva o nome de um dado do evento entre chaves, como {id}, e ele é trocado pelo valor real.
  • Dados dentro de outros dados: use o ponto, como {contato.email}.
  • Texto com valores: misture texto e chaves, como "Conversa finalizada - {id}".

Configurar ​

  1. Abra o webhook em Detalhes (ou crie um em Novo webhook).
  2. Na aba Inscrições, ligue o evento e, de preferência, Enviar apenas o payload. Assim, os nomes entre chaves ficam mais simples. Sem essa opção, é preciso começar o caminho por data, como {data.id} em vez de {id}.
  3. Na aba Modificadores de dados, escreva o modelo no campo Modificador do evento.
  4. Salve o webhook.

Exemplo ​

Dados originais de um ticket fechado (trecho):

{
  "id": 3919,
  "client_name": "Cliente Exemplo",
  "client_phone": "5562999990000",
  "closed_at": "2026-09-22T17:22:04.242Z",
  "observations": "Sistema: Olá, a partir de agora Atendente X irá lhe atender!"
}

Modelo escrito no Modificador:

{
  "event_type": "CHAT_FINISHED",
  "payload": {
    "chat_subject": "Conversa finalizada - {id}",
    "cf_chat_status": "offline",
    "cf_chat_transcript_message": "{observations}"
  }
}

O que o sistema de destino recebe:

{
  "event_type": "CHAT_FINISHED",
  "payload": {
    "chat_subject": "Conversa finalizada - 3919",
    "cf_chat_status": "offline",
    "cf_chat_transcript_message": "Sistema: Olá, a partir de agora Atendente X irá lhe atender!"
  }
}

Bom saber

O dado observations traz a transcrição das mensagens trocadas e existe só nos eventos de ticket, como Ticket fechado e Ticket transferido. Arquivos aparecem na transcrição apenas com o tipo (imagem, vídeo, áudio ou documento) e o nome.

Veja também ​