Ferramentas do servidor MCP da Omnifox: referência completa
As 72 ferramentas que o @omnifox/mcp-server expõe, agrupadas por módulo e com o que cada uma faz.
Veja este passo no vídeo · MCP: que uma IA opere o Omnifox
Esta é a lista completa de ferramentas que o servidor MCP da Omnifox coloca à disposição do assistente. Os nomes são os que você verá no registro do seu cliente de IA. Na versão 0.4.0 são 72.
Duas regras transversais: todos os ids são inteiros positivos, nunca UUID; e onde se pede um contato também é aceito um seletor tipo:valor (email:[email protected], phone:+593987654321, external:abc).
Contatos (11)
| Ferramenta | O que faz |
|---|---|
get_contact |
Traz um contato por id ou por seletor. |
create_contact |
Cria um contato. display_name é o único campo obrigatório. |
update_contact |
Atualiza apenas os campos que você envia. |
delete_contact |
Exclui o contato e tudo o que depende dele. Irreversível. |
list_contacts |
Lista contatos, os mais ativos primeiro. |
search_contacts |
Busca livre por nome, e-mail e telefone (mínimo de 2 caracteres). |
add_contact_tags |
Adiciona etiquetas por nome; cria as que não existirem. |
remove_contact_tags |
Remove etiquetas por nome. |
create_or_update_contact |
Criação idempotente: busca pelas chaves que você indicar e cria se não houver correspondência. |
merge_contacts |
Mescla um contato dentro de outro. O principal sobrevive. |
list_contact_channels |
Lista as identidades de canal do contato. |
Mensageria (5)
| Ferramenta | O que faz |
|---|---|
send_message |
Envia para um contato. Reaproveita a conversa aberta dele ou abre uma. Tipos: text, attachment, quick_reply, whatsapp_template, email. |
send_conversation_message |
Envia dentro de uma conversa cujo id você já conhece. Com type: note deixa uma nota interna. |
get_message |
Traz uma mensagem com o status de entrega. |
list_messages |
Lista as mensagens de uma conversa, da mais antiga para a mais nova. |
retry_message |
Tenta novamente a entrega de uma mensagem que falhou. |
Os anexos trafegam como URL pública: a Omnifox faz o download. O servidor MCP não faz upload de arquivos.
Conversas (9)
| Ferramenta | O que faz |
|---|---|
list_conversations |
Lista conversas; filtra por open, pending, resolved, closed ou snoozed. |
get_conversation |
Traz uma conversa com contato, canal, status e atribuição. |
get_conversation_sending_window |
Diz se ainda dá para mandar texto livre ou se é necessário um modelo. |
assign_conversation |
Atribui a usuário, equipe ou agente de IA, ou remove a atribuição. |
assign_contact_conversation |
Atribui a conversa aberta do contato quando você não tem o id dela. |
update_conversation_status |
Reabre, resolve ou encerra, com etiqueta de resolução e notas. |
update_contact_conversation_status |
O mesmo, partindo do contato. |
snooze_conversation |
Adia a conversa para que ela volte mais tarde. |
list_conversation_notes |
Lista as notas internas da thread. |
create_comment |
Adiciona uma nota interna a uma conversa. |
Espaço de trabalho (13)
list_users, get_user, set_user_status, list_custom_fields, get_custom_field, create_custom_field, list_channels, list_snippets, list_templates, list_tags, create_tag, update_tag, delete_tag.
Servem para descobrir ids antes de agir: list_channels e list_users são quase sempre a primeira chamada útil.
Agenda e compromissos (13)
list_calendars, list_services, list_resources, list_sites, list_free_slots, book_appointment, list_appointments, reschedule_appointment, cancel_appointment, list_enrollments, enroll_contact, mark_attendance, cancel_enrollment.
Regra de ouro: sempre chame list_free_slots antes de oferecer ou reservar um horário, e passe o starts_at exatamente como ele foi devolvido.
Catálogo e pedidos (10)
search_products, get_product, create_product, update_product, list_orders, get_order, create_order, set_order_status, record_order_payment, get_catalog_settings.
Os valores não são enviados: o servidor calcula cada linha com o catálogo e os impostos do espaço de trabalho.
Fluxos, disparos em massa, webhooks e relatórios (11)
list_workflows, trigger_workflow, set_workflow_active, list_broadcasts, create_broadcast, cancel_broadcast, register_webhook, list_webhooks, list_workspaces, get_report.
O get_report aceita quatro relatórios: overview, conversations, agents e heatmap, com períodos today, yesterday, 7d, 30d, 90d, this_month e last_month (por padrão, os últimos 30 dias).
Dicas
- As respostas vêm sem o envelope
{success, data}e com as listagens achatadas em{items, page, last_page, per_page, total}: é menos ruído para o modelo. - No WhatsApp, fora da janela de 24 horas só é entregue um modelo aprovado. Consulte
list_templatese envie comsend_messageusandotype: whatsapp_template.
Artigos relacionados
Artigos relacionados
-
Como conectar integrações e apps externos
Conecte o Omnifox às suas ferramentas favoritas a partir do catálogo de integrações em poucos passos.
-
Integrar o Omnifox com Azur, Siigo, Alegra, QuickBooks ou outro sistema contábil ou ERP
O Omnifox não tem hoje um conector nativo com sistemas contábeis ou ERP. Veja como fazer essa conexão mesmo assim com fluxos de trabalho, o nó HTTP, n8n, Make, Zapier ou a API, com exemplos.
-
Guia completo de integrações e API
Integrações e API a fundo, em 30 capítulos: chaves de API, chamadas reais, webhooks assinados, n8n, MCP e SDKs, tudo funcionando de verdade.
-
Gerar e usar API keys e webhooks
Crie chaves de API para acessar o Omnifox por código e configure webhooks para receber eventos em tempo real.
-
Introdução às integrações (webhook / OAuth / chave de API)
Conecte o Omnifox às suas outras ferramentas: o que está disponível hoje, o que chega em breve e quando usar um webhook, uma conexão OAuth ou uma chave de API.