Webhook por inatividade

O webhook por inatividade manda um POST com os dados do lead para um endereço seu depois de um tempo sem interação. Serve para avisar um vendedor, criar uma tarefa no CRM externo ou disparar uma cadência em outra ferramenta quando o lead esfria.

Onde fica no painel

Automações → Automações nativas → criar → Webhook por Inatividade. Funciona em todas as conexões.

Como configurar

Campo	O que faz	Padrão
Nome do Webhook	Nome na lista. Também vai no payload, no campo `name`. Obrigatório.	—
URL de destino	O endereço que recebe o `POST`. URL válida, obrigatória.	—
Tempo de inatividade	Número inteiro, mínimo 1, em Minutos, Horas ou Dias.	—
Tags (opcional)	Só leads com pelo menos uma das tags. Vazio vale para todos.	Todos
Colunas (opcional)	Só leads em uma das colunas. Vazio vale para todos.	Todos

Salvar com o webhook ligado também zera a contagem de falhas do desligamento automático (veja Webhooks de eventos).

Como funciona por trás

Quando é agendado e cancelado

Segue o mesmo ciclo do follow-up (Quando as automações disparam):

Agenda a cada interação concluída: o agente respondeu, um humano respondeu pelo CRM, o lead foi movido pelo CRM para uma coluna com “Disparar automações”, ou POST /automations/trigger.
Refaz do zero a cada nova interação concluída. “Inatividade” é o tempo desde a última interação.
Cancela quando o lead escreve com a IA pausada ou desligada, ou com o agente fora do horário.

O payload é uma foto do agendamento

O JSON é montado quando a interação termina, não quando é enviado. Se o webhook é de 2 dias, ele leva a coluna, as tags e as propriedades que o lead tinha 2 dias antes. Na hora do envio, a Zatten só confere se o webhook continua ligado, se o lead ainda bate nas tags e colunas do filtro e se a conversa não foi encerrada. Se o lead mudou de coluna e saiu do filtro, nada é enviado.

O envio

POST com Content-Type: application/json, tempo limite de 20 segundos, sem assinatura e sem nova tentativa. Dez falhas seguidas desligam o webhook, igual ao webhook de eventos.

Payload

O mesmo formato dos eventos de lead e conversas do webhook de eventos, com name no lugar de type:

{
  "name": "Lead esfriou 2h",
  "lead": {
    "id": "6f1c2b9e-3a4d-4c55-9a77-0d2e1f3b4c5d",
    "name": "Maria Souza",
    "wa_id": "5511999998888",
    "thread_id": "zt_8d7c6b5a",
    "last_interaction": "2026-10-06T14:03:21.000+00:00",
    "conversation_expires_in": "2026-10-07T14:03:21+00:00",
    "created_at": "2026-10-01T09:12:44.512+00:00",
    "ai_response_block": false,
    "tags": ["b2c1d0e9-0000-4000-8000-000000000001"],
    "tenant_id": "a1b2c3d4-0000-4000-8000-000000000002",
    "unread_messages": 0,
    "column_id": "c0l00000-0000-4000-8000-000000000003",
    "metadata": [
      { "prop_name": "cidade", "prop_value": "Campinas" }
    ],
    "assigned_to_user": "u5e7r000-0000-4000-8000-000000000004",
    "zatten_thread_id": "zt_8d7c6b5a"
  },
  "attendant": {
    "id": "p40j3t00-0000-4000-8000-000000000006",
    "meta_number_id": "102030405060708"
  },
  "timestamp": "2026-10-06T14:03:22.000Z"
}

timestamp é o momento do agendamento, não do envio. A hora do envio é aproximadamente timestamp + o tempo de inatividade.
Não há message.
Campos sem valor não vêm. tags são ids; metadata usa o slug da propriedade em prop_name. Significado de cada campo em Webhooks de eventos.