Ferramentas MCP
O servidor MCP expõe ferramentas agrupadas por área do produto. A lista abaixo é a referência de leitura; a lista autoritativa é a que o servidor devolve ao seu cliente (tools/list) — ela varia conforme o seu perfil e os recursos habilitados na empresa.
Uma ferramenta fora do seu perfil simplesmente não aparece: não existe chamada que contorne a permissão.
Conversas
| Ferramenta | O que faz |
|---|---|
list_open_conversations | Conversas aguardando resposta / abertas, com filtros por tag, não lidas e data |
list_archived_conversations | Conversas arquivadas |
list_finished_conversations | Conversas finalizadas |
search_inbox | Busca em conversas, contatos e mensagens |
get_conversation_details | Dados da conversa: canal, fila, atendente, tags, estado |
get_conversation_history | Histórico de mensagens da conversa |
take_conversation | Assume a conversa para o usuário |
transfer_conversation | Transfere para outra fila ou atendente, com recado |
finish_conversation | Finaliza o atendimento; conversas de anúncio exigem classification |
reopen_conversation | Reabre uma conversa finalizada |
update_conversation | Marca lida/não lida, arquiva, silencia, fixa |
update_conversation_tags | Aplica e remove tags |
list_transfer_targets | Filas e atendentes para onde transferir |
recalculate_cx_score | Recalcula o CX Score de uma conversa finalizada |
Mensagens e mídia
| Ferramenta | O que faz |
|---|---|
send_message | Envia texto na conversa |
send_template | Envia um template aprovado (com variáveis) |
send_media | Envia mídia (base64, até 2 MB) |
get_message_media | Recupera a mídia de uma mensagem |
list_conversation_media | Lista a mídia da conversa |
update_message | Edita o conteúdo de uma mensagem |
react_to_message | Reage a uma mensagem |
cancel_scheduled_message | Cancela um template agendado |
list_starred_messages | Mensagens marcadas com estrela |
list_templates | Templates aprovados do canal da conversa |
start_conversation | Inicia uma conversa nova (canal + identificador) |
Contatos e notas
| Ferramenta | O que faz |
|---|---|
search_contacts | Busca contatos |
get_contact | Ficha do contato |
create_contact / update_contact / delete_contact | CRUD de contato |
import_contacts | Importa contatos em lote a partir de CSV |
find_contact_matches | Procura contatos duplicados antes de criar |
list_contact_owners / transfer_contact_owner | Donos e transferência de dono |
convert_conversation_to_contact | Converte a conversa em contato do CRM |
unlink_conversation_contact | Desvincula a conversa do contato |
rename_conversation_contact | Renomeia o contato pela conversa |
add_contact_note / list_contact_notes | Notas internas sobre o contato |
CRM (contas e oportunidades)
| Ferramenta | O que faz |
|---|---|
search_accounts, get_account, create_account, update_account, delete_account | CRUD de conta |
list_account_owners, transfer_account_owner | Donos e transferência |
search_opportunities, get_opportunity, create_opportunity, update_opportunity, delete_opportunity | CRUD de oportunidade |
transfer_opportunity_owner | Transferência de dono |
list_opportunity_stages, create_opportunity_stage, update_opportunity_stage, delete_opportunity_stage, reorder_opportunity_stages | Ciclo e etapas do funil |
Campanhas
| Ferramenta | O que faz |
|---|---|
list_campaigns / get_campaign | Lista e detalhe |
create_campaign / update_campaign / update_campaign_details | Montagem e edição |
delete_campaign | Exclui (respeitando o estado) |
dispatch_campaign | Dispara um rascunho |
cancel_campaign | Cancela uma campanha agendada |
mark_campaign_winner | Marca a variante vencedora do A/B |
get_campaign_dashboard | Métricas da campanha |
list_campaign_channels / list_campaign_templates | Canais e templates disponíveis |
list_campaign_audience_reports / preview_campaign_audience_report | Relatórios elegíveis como público |
upload_campaign_audience_csv | Envia o público por CSV |
Relatórios e listas de exibição
| Ferramenta | O que faz |
|---|---|
list_reports, run_report | Lista e executa relatórios |
describe_report_type | Tipos e campos disponíveis |
create_report, update_report, delete_report | CRUD de relatório |
get_report_config, save_report_config | Leitura e gravação da configuração (colunas, grupos, filtros) |
get_report_shares, share_report | Compartilhamento |
describe_view_fields | Campos, operadores e colunas válidas por tela |
list_views, create_view, update_view, delete_view | Listas de exibição |
run_view | Executa uma lista de exibição |
Configurações e plataforma
| Ferramenta | O que faz |
|---|---|
whoami | Usuário, empresa, perfil e recursos habilitados |
list_users, create_user, list_roles | Usuários e perfis |
create_role, update_role | Perfis de acesso |
list_channels | Canais conectados |
list_custom_fields, create_custom_field, update_custom_field, delete_custom_field | Campos personalizados |
list_agent_workspaces, update_agent_workspace | Agentes de IA por canal |
get_company_features, update_company_features | Recursos da empresa |
get_entity_labels, update_entity_labels | Nomes das entidades |
Erros e o que fazer
As recusas vêm com uma dica de correção em texto, além do código. Alguns exemplos:
| Código | Dica |
|---|---|
session_assigned_to_other | A conversa é de outra pessoa — chame take_conversation antes |
session_expired_template_required | Janela de 24 h fechada — use list_templates e send_template |
session_closed | Conversa finalizada — use reopen_conversation |
unknown_tag | A tag não existe — confira com a listagem de tags |
too_many_rows | Divida em lotes de até 5.000 contatos |
validation_error | Os campos com problema vêm no detalhe do erro |
O catálogo de códigos é o mesmo usado pela API interna — o assistente recebe a instrução, não só a falha.