# Docs Zatten

## Docs

- [Introdução](https://docs.zatten.com/api-reference/introduction.md): Guia de referência para os endpoints da API.
- [Busca informações de todas as colunas](https://docs.zatten.com/api-reference/kanban/busca-informações-de-todas-as-colunas.md): Recupera uma lista com todas as colunas do Kanban configuradas para o atendente, incluindo ID, nome, descrição e cor de identificação.
- [Adiciona uma tag a um lead](https://docs.zatten.com/api-reference/leads/adiciona-uma-tag-a-um-lead.md): Associa uma tag existente a um lead específico. A tag deve estar previamente cadastrada no sistema.
- [Ativa ou desativa a resposta da IA para um lead](https://docs.zatten.com/api-reference/leads/ativa-ou-desativa-a-resposta-da-ia-para-um-lead.md): Permite controlar programaticamente se o atendente de IA pode ou não responder a um lead específico. Útil para cenários onde uma intervenção humana é necessária e a IA deve ser silenciada temporariamente.
- [Atualiza a anotação de um lead](https://docs.zatten.com/api-reference/leads/atualiza-a-anotação-de-um-lead.md): Adiciona ou substitui a anotação (nota) de um lead existente. É possível concatenar a nova nota com a anterior ou sobrescrevê-la completamente.
- [Atualiza o responsável (usuário e departamento) de um lead](https://docs.zatten.com/api-reference/leads/atualiza-o-responsável-usuário-e-departamento-de-um-lead.md): Atribui um lead a um usuário e a um departamento (time) específicos. O usuário informado precisa pertencer ao departamento informado.
- [Atualiza uma propriedade de um lead](https://docs.zatten.com/api-reference/leads/atualiza-uma-propriedade-de-um-lead.md): Modifica o valor de uma propriedade customizada associada a um lead. A propriedade (identificada pelo seu `slug`) deve ter sido previamente cadastrada no sistema.
- [Lista todas as threads de um lead](https://docs.zatten.com/api-reference/leads/lista-todas-as-threads-de-um-lead.md): Retorna o histórico de threads (atendimentos) do lead, ordenado da mais recente para a mais antiga. A thread atual é a única com `closed_at` nulo. As demais foram encerradas (via reinício de thread). Use o `thread_id` retornado para buscar mensagens dessa thread em `/messages/history`.
- [Move um lead no Kanban](https://docs.zatten.com/api-reference/leads/move-um-lead-no-kanban.md): Altera a coluna do lead no Kanban.
- [Obtém informações do lead](https://docs.zatten.com/api-reference/leads/obtém-informações-do-lead.md): Retorna os detalhes completos de um lead, incluindo tags, coluna do kanban e metadados.
- [Reinicia a thread de conversa de um lead](https://docs.zatten.com/api-reference/leads/reinicia-a-thread-de-conversa-de-um-lead.md): Gera um novo ID de thread para o lead, efetivamente arquivando a conversa atual e iniciando uma nova. Útil para limpar o contexto que a IA utiliza para responder, sem apagar o histórico de mensagens.
- [Remove uma tag de um lead](https://docs.zatten.com/api-reference/leads/remove-uma-tag-de-um-lead.md): Desassocia uma tag de um lead específico. O ID da tag deve ser enviado no corpo da requisição.
- [Busca o histórico de mensagens de um lead](https://docs.zatten.com/api-reference/mensagens/busca-o-histórico-de-mensagens-de-um-lead.md): Recupera o histórico de conversas e os dados associados a um lead, identificado pelo seu número de telefone. Pode retornar os dados em formato JSON ou como um texto único formatado para uso com Modelos de Linguagem (LLMs).
- [Envia uma mensagem de arquivo](https://docs.zatten.com/api-reference/mensagens/envia-uma-mensagem-de-arquivo.md): Envia um arquivo (PDF, DOCX, etc.) para o lead através de upload via multipart/form-data. Requer que o lead exista e esteja dentro da janela de conversa de 24h. Permite definir um nome de arquivo personalizado.
- [Envia uma mensagem de imagem](https://docs.zatten.com/api-reference/mensagens/envia-uma-mensagem-de-imagem.md): Envia uma imagem para o lead através de upload via multipart/form-data. Requer que o lead exista e esteja dentro da janela de conversa de 24h. Suporta legenda (caption) opcional.
- [Envia uma mensagem de template](https://docs.zatten.com/api-reference/mensagens/envia-uma-mensagem-de-template.md): Inicia uma conversa ou envia uma notificação para um lead utilizando um template pré-aprovado do WhatsApp. Se o lead com o `lead_number` informado não existir, um novo será criado no sistema.
- [Envia uma mensagem de texto](https://docs.zatten.com/api-reference/mensagens/envia-uma-mensagem-de-texto.md): Envia uma mensagem de texto simples (não-template) para um lead **existente**. Esta rota só funciona **dentro da janela de conversa de 24 horas** iniciada pelo lead.
- [Envia uma mensagem de vídeo](https://docs.zatten.com/api-reference/mensagens/envia-uma-mensagem-de-vídeo.md): Envia um vídeo para o lead. Formatos suportados: video/mp4, video/3gpp.
- [Envia uma mensagem de áudio](https://docs.zatten.com/api-reference/mensagens/envia-uma-mensagem-de-áudio.md): Envia um arquivo de áudio para o lead. O sistema converte automaticamente o arquivo para o formato OGG Opus (formato nativo de voz do WhatsApp). Requer que o lead exista e esteja dentro da janela de conversa de 24h.
- [Busca informações de todas as tags](https://docs.zatten.com/api-reference/tags/busca-informações-de-todas-as-tags.md): Recupera uma lista com todas as etiquetas (tags) configuradas para o atendente, incluindo ID, nome, descrição e cor.
- [Criar sua Conta](https://docs.zatten.com/introducao/criarconta.md): Da criação da conta à estrutura do primeiro agente
- [Perguntas Frequentes](https://docs.zatten.com/introducao/faq.md): Respostas rápidas para as dúvidas mais comuns sobre a Zatten
- [O que é a Zatten?](https://docs.zatten.com/introducao/visaogeral.md): Plataforma white label de agentes de IA para WhatsApp
- [Live #2 - Prompts de Qualidade](https://docs.zatten.com/lives/live-2.md)
- [Live #3 - Base de Conhecimento (RAG)](https://docs.zatten.com/lives/live-3.md)
- [Live #4 - Processo Comercial com IA](https://docs.zatten.com/lives/live-4.md)
- [Live #5 - Onboarding de Clientes](https://docs.zatten.com/lives/live-5.md)
- [Live #6 - Planejamento e Metas 2026](https://docs.zatten.com/lives/live-6.md)
- [Live #7 - Homologação e Testes](https://docs.zatten.com/lives/live-7.md)
- [Live #8 - Campanhas e API Oficial](https://docs.zatten.com/lives/live-8.md)
- [Live #9 - A Máquina de Vendas](https://docs.zatten.com/lives/live-9.md)
- [Agendamento](https://docs.zatten.com/tutorial/agente/acoes/agendamento.md)
- [Captura de Dados](https://docs.zatten.com/tutorial/agente/acoes/captura-dados.md)
- [Controle da IA](https://docs.zatten.com/tutorial/agente/acoes/controle-ia.md)
- [Kanban](https://docs.zatten.com/tutorial/agente/acoes/kanban.md)
- [MCPs](https://docs.zatten.com/tutorial/agente/acoes/mcp.md)
- [Tags](https://docs.zatten.com/tutorial/agente/acoes/tags.md)
- [Transferência](https://docs.zatten.com/tutorial/agente/acoes/transferencia.md)
- [Webhooks Personalizados](https://docs.zatten.com/tutorial/agente/acoes/webhooks.md)
- [Configurações Avançadas](https://docs.zatten.com/tutorial/agente/configuracoes-avancadas.md)
- [Base de Conhecimento](https://docs.zatten.com/tutorial/agente/conhecimento.md)
- [Escolha do Modelo de IA](https://docs.zatten.com/tutorial/agente/escolha-modelo.md)
- [Chave API OpenAI](https://docs.zatten.com/tutorial/agente/openai-key.md)
- [Preview do Chat](https://docs.zatten.com/tutorial/agente/preview-chat.md)
- [Prompt do Sistema](https://docs.zatten.com/tutorial/agente/prompt-sistema.md)
- [Central de Automações](https://docs.zatten.com/tutorial/automacoes/index.md)
- [Conta e Projetos](https://docs.zatten.com/tutorial/configuracoes/conta-projeto.md)
- [Gerenciar Acessos](https://docs.zatten.com/tutorial/configuracoes/gerenciar-acessos.md)
- [Minha Empresa (White Label)](https://docs.zatten.com/tutorial/configuracoes/minha-empresa.md)
- [Gestão de Leads](https://docs.zatten.com/tutorial/crm/informacoes-lead.md)
- [Cal.com](https://docs.zatten.com/tutorial/integracao/cal.md)
- [Conectar WhatsApp (API Cloud)](https://docs.zatten.com/tutorial/whatsapp/ativar-whatsapp.md)
- [Templates de Mensagem](https://docs.zatten.com/tutorial/whatsapp/templates.md)
- [Referência dos Webhooks](https://docs.zatten.com/webhooks/referencia-webhooks.md): Guia completo sobre os eventos, payloads e campos enviados pelos webhooks da Zatten.

## OpenAPI Specs

- [zattenapi](https://docs.zatten.com/api-reference/zattenapi.json)

## Optional

- [Dashboard](https://app.zatten.com/)
- [Site](https://zatten.com)