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.

Aug 19, 2026

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_templates e envie com send_message usando type: whatsapp_template.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp