Dados da conta Kommo (id, nome, subdomínio, moeda, fuso). Use para confirmar conexão.

Lista todos os funis e suas etapas (id, nome, ordem). Use para descobrir pipeline_id/status_id antes de criar ou mover leads.

Lista usuários (id, nome, email). Use para mapear nome -> responsible_user_id ao trocar responsáveis.

Lista campos personalizados de uma entidade (leads/contacts/companies). Use para achar field_id (ex.: campos 'N8N | ...' de tracking).

Busca leads. Filtra por texto (query), funil, etapa e responsável. Retorna leads com contatos embutidos.

Detalhe completo de um lead por id, com contatos. Use note_limit>0 para anexar as últimas notas.

Cria um lead. Opcionalmente já vincula um contato (nome + telefone) e seta campos custom.

Atualiza um lead: mover de etapa/funil (status_id/pipeline_id), preço, responsável, nome ou campos custom.

Troca o responsável de um ou vários leads de uma vez (operação em lote).

Adiciona uma nota de texto a um lead (ou contato/empresa).

Cria uma tarefa vinculada a um lead (ou outra entidade), com prazo e responsável.

Marca uma tarefa como concluída, opcionalmente com texto de resultado.

Lista tarefas. Filtra por responsável, entidade e status (concluída ou não).

Feed de eventos (auditoria). Essencial para ENTENDER BOTS: quem mudou o quê, quando. Filtre created_by=0 para ações de bot/automação nativa. Tipos comuns: lead_status_changed, entity_responsible_changed, lead_added, incoming_chat_message.

Busca contatos por texto (nome, telefone, email).

Cria uma nova ETAPA dentro de um funil (desenvolver etapas). Informe pipeline_id, name e opcionalmente sort/color.

Renomeia/reordena/recolore uma etapa existente.

Cria um contato. Telefone/email viram custom fields PHONE/EMAIL automaticamente.

Atualiza um contato existente (nome, responsável, campos custom).

Busca empresas por texto (nome, etc.).

Cria uma empresa.

Atualiza uma empresa existente.

Vincula uma entidade a outra (ex.: contato↔lead, empresa↔lead/contato).

Lista os webhooks configurados na conta (destino e eventos assinados).

Assina um webhook: envia eventos da Kommo para uma URL. settings = lista de eventos (ex.: add_lead, status_lead, update_lead, add_contact, add_task).

Remove (cancela) um webhook pela URL de destino.

Cria um campo personalizado numa entidade. type: text, numeric, select, multiselect, date, url, checkbox, textarea, etc. Para select/multiselect, passe enums.

Atualiza um campo personalizado (renomear, etc.).

Passthrough genérico autenticado da API v4 da Kommo, para qualquer coisa não coberta pelas tools acima. path relativo (ex.: '/companies'). Cuidado: PATCH/POST/DELETE alteram dados.