Controle da IA por lead e encerrar atendimento

​

Os três estados da IA num lead

​

POST /leads/{numero}/toggle-attendant-response

​

Corpo

• Pausar uma IA já pausada só estende. Se a pausa atual termina depois do novo prazo, nada muda.
• Pausar uma IA desligada não muda nada. Ela continua desligada; a pausa não a “religa no fim”.
• Ligar quem já está ligada, ou desligar quem já está desligada, não muda nada.

​

Resposta

{
  "message": "Attendant response toggled from on to paused",
  "status": "paused",
  "ai_response_block_until": "2026-10-06T15:30:00.000-03:00"
}

​

Erros

​

Exemplos

# Pausar 30 minutos (um humano vai responder agora)
curl -X POST "https://api.zatten.com/api/v1/leads/5511999998888/toggle-attendant-response" \
  -H "x-api-key: $ZATTEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false, "pause_minutes": 30 }'

# Religar
curl -X POST "https://api.zatten.com/api/v1/leads/5511999998888/toggle-attendant-response" \
  -H "x-api-key: $ZATTEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true }'

​

PATCH /leads/{numero}/thread

curl -X PATCH "https://api.zatten.com/api/v1/leads/5511999998888/thread" \
  -H "x-api-key: $ZATTEN_API_KEY"

​

O que muda no lead

​

Erros

​

Armadilhas

• {"enabled": false} sem pause_minutes desliga de vez. Se a intenção é “um humano vai responder rapidinho”, mande pause_minutes.
• pause_minutes vazio dá 400. Uma variável que resolveu para vazio não vira desligamento: tire o campo se quiser desligar.
• Pausa não religa uma IA desligada. Para garantir que a IA volte, ligue (enabled: true) e depois pause.
• Pausa só estende. Não dá para encurtar uma pausa com outra menor: ligue e pause de novo.
• As mensagens da pausa ficam sem resposta. Ao religar, o agente não responde ao que ficou para trás; espera a próxima mensagem do lead. Se precisar, mande uma mensagem pela API.
• Encerrar apaga a memória da conversa para o agente e tira as tags e propriedades de vínculo conversa. O que precisa sobreviver vai numa propriedade de vínculo contato ou na anotação.
• Encerrar religa a IA, mesmo de um lead que um humano tinha desligado de propósito.
• Encerrar não dispara automações de coluna, embora o lead volte para a primeira coluna.

​

Para saber mais

• Pausa quando um humano assume
• Encerrar atendimento
• Leads, Fluxos e webhook de entrada
• Termos para buscar: “human handoff”, “pause AI agent”, “conversation reset”.