# Ciclo de vida da conversa

Como uma conversa Zild vai da entrada ao atendimento por IA, handoff humano, avaliação, relatórios e follow-up.

Source: https://zild.ai/pt-BR/docs/api-reference/conversation-lifecycle

## Visão geral do ciclo

Uma conversa começa quando um evento externo entra na Zild ou quando uma integração autorizada cria uma conversa proativa. A partir daí, agente, canal, fila, template e checklist definem como a interação será tratada.



<table class="api-params"><thead><tr><th>Etapa</th><th>O que acontece</th><th>Evidência para enviar</th></tr></thead><tbody><tr><td>Entrada</td><td>A Zild recebe e-mail, áudio, transcrição do Teams, requisição proativa de WhatsApp ou chamada telefônica.</td><td>Canal, tipo de integração, identificador de origem, participante, timestamp e conteúdo.</td></tr><tr><td>Contexto</td><td>A Zild vincula o evento ao tenant, bot/agente, fila, checklist, usuário e tipo de conversa corretos.</td><td>IDs de <code>botId</code>, <code>channelId</code>, <code>queueId</code>, <code>checklistId</code>, <code>conversationType</code> e variáveis.</td></tr><tr><td>Ação</td><td>O agente pode responder, iniciar fluxo, criar registro ou deixar para revisão humana.</td><td>Templates aprovados e metadados confiáveis.</td></tr><tr><td>Handoff</td><td>Se a automação não deve continuar, a conversa permanece visível para fila ou usuário.</td><td><code>liveAgent</code>, fila, dono da conversa e status.</td></tr><tr><td>Avaliação</td><td>Zild Insight ou Coach pontua, resume, classifica e sinaliza erros ou baixa confiança.</td><td>Checklist, transcrição/áudio/mensagens, status da chamada, duração, sentimento e status de avaliação.</td></tr><tr><td>Follow-up</td><td>A plataforma pode gerar tarefas, relatórios, CRM ou novo contato conforme configuração.</td><td>ID da conversa Zild, IDs externos, tags e referências do sistema de origem.</td></tr></tbody></table>



## Registros para armazenar

Armazene o `conversation.id` retornado sempre que um endpoint devolver uma conversa. Para voz, armazene também o `callSid`. Para importações, preserve o identificador de áudio ou transcrição no sistema de origem.

## O que não enviar

Não envie API keys no corpo da requisição. Não inclua segredos em `contentVariables`. Evite enviar dados que o agente configurado não precisa.