Webhooks e N8N · Central de Ajuda Jarvis

Receba eventos do Jarvis em tempo real no N8N ou no seu sistema, por canal, por fila, da Agenda e do Kanban.

Webhook é um aviso automático: quando algo acontece no Jarvis (mensagem recebida, atendimento encerrado, agendamento criado), o sistema envia os dados para uma URL sua, como um fluxo do N8N, Make ou o seu próprio servidor.

	Direção	Exemplo
Webhook	Jarvis → seu sistema	"Chegou uma mensagem nova"
API	Seu sistema → Jarvis	"Envie esta mensagem" (saiba mais)

Onde: Automação e Integrações → Webhooks/N8N.

Webhook por canal#

Envia eventos de todos os atendimentos de um canal.

Na aba Integrações por Canal, clique em Configurar no canal.
Ligue Integração ativada e informe a URL de destino.
Marque os eventos (sem nenhum marcado, nada é enviado).
Opcional: informe um token em configurações avançadas.
Clique em Testar integração e salve.

Eventos#

Evento	Quando dispara
Mensagem recebida / Mensagem enviada	A cada mensagem
Novo ticket	Atendimento criado por um usuário ou aberto por mensagem recebida
Ticket transferido	Mudança de fila ou de usuário
Ticket fechado	Encerramento (inclui o motivo, se houver)
Ticket em atendimento / Ticket pendente	Filtros: só envia mensagens de atendimentos nesses status
Mensagens de grupo	Sem essa opção, grupos não geram webhook
Enviar mídia em base64	Inclui o arquivo dentro do envio (aumenta o volume de dados)

Webhook por fila (N8N)#

Envia eventos apenas dos atendimentos que estão em uma fila específica. Ideal para um fluxo do N8N que assume parte do atendimento.

Na aba Integrações por Fila, clique em Nova Integração N8N.
Informe nome, URL (método POST), eventos e, se quiser, o token.
Teste e salve.
Clique em Vincular à fila (o assistente usa uma fila existente ou cria uma nova) e escolha os canais.

Quando um atendimento é transferido para essa fila, a integração começa a enviar os eventos daquele atendimento. A aba Fila tem os eventos de mensagem, filtros de status, grupos e mídia base64 (sem os eventos de ciclo de vida do ticket).

Webhooks da Agenda, Kanban e Kanban Pro#

Nas abas Webhook da Agenda, Webhook do Kanban e Webhook do Kanban Pro, clique em Novo webhook:

Agenda: agendamento criado, alterado, remarcado, cancelado, excluído e mudança de status. Filtro opcional por calendário.
Kanban: cartão criado, alterado, movido, excluído, status (etapa ganha) e responsável.
Kanban Pro: os mesmos eventos, com filtro opcional por quadro.

Use Testar integração e o ícone Últimos envios para ver o histórico e possíveis erros.

Detalhes técnicos#

Requisições POST com corpo JSON.
Primeiro envio cerca de 3 segundos após o evento; em caso de falha, até 3 tentativas com 3 minutos de intervalo.
Autenticação dos webhooks de canal e fila: o token vai no cabeçalho X-N8N-API-KEY (não em Authorization).
Autenticação dos webhooks de Agenda e Kanban: o token vai no cabeçalho Authorization: Bearer.
O teste envia um evento test e mostra o código HTTP e a duração (sucesso = 2xx; tempo limite de 10 segundos).

Principais campos enviados (canal)#

Type: tipo do evento de ticket (NewTicket, NewTicketUserCreate, TransferTicket, ClosedTicket). Eventos de mensagem não têm esse campo.
ticket: id, status, protocol, queueId, userId e a chave externa enviada pela API.
contact: id, name, phoneNumber, email, isGroup, entre outros.
whatsapp: id e name da conexão.
Mensagens: messageId, messageBody, timestamp, fromMe, mediaType, mediaUrl, mediaBase64 (se ativado) e quem enviou em grupos.

Nada chega no destino?#

A integração está ativa (canal) ou vinculada à fila onde está o atendimento?
A URL é pública, usa https:// e está acessível (firewall, certificado)?
Há eventos marcados? Os filtros de status estão ligados?
Se for mensagem de grupo, a opção de grupos está marcada?
O token confere com o que o destino espera (X-N8N-API-KEY)?
Lembre-se das retentativas: o envio pode chegar alguns minutos depois.

No N8N, confira a aba Executions para ver se a chamada chegou.