Ferramentas Disponíveis
Lista completa de ferramentas disponíveis no nosso servidor MCP.
Mensagens
send_message
Envia uma mensagem para um contato.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| phone | string | Sim | Número do destinatário com código do país |
| channel | string | Sim | ID do canal |
| content | string | Sim | Conteúdo da mensagem |
| type | string | Não | Tipo: text, image, video, audio, document. Default: text |
| path | string | Condicional | URL do arquivo (obrigatório para tipos de mídia) |
Exemplo de uso:
“Envie uma mensagem para 5511999999999 usando o canal 01arz3ndektsv4rrffq69g5fav dizendo: Olá, tudo bem?“
list_messages
Lista mensagens de um chat.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| chat_id | string | Sim | ID do chat |
| page | integer | Não | Página. Default: 1 |
| per_page | integer | Não | Registros por página (máx: 100). Default: 20 |
Exemplo de uso:
“Mostre as últimas mensagens do chat 01arz3ndektsv4rrffq69g5fav”
Chats
list_chats
Lista as conversas.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| status | string | Não | Filtrar por status: entrance, waiting, finished |
| is_open | boolean | Não | Filtrar por chats abertos ou fechados |
| contact | string | Não | Filtrar por ID ou telefone do contato |
| tag | string | Não | Filtrar por ID da tag |
| channel | string | Não | Filtrar por ID do canal |
| page | integer | Não | Página. Default: 1 |
| per_page | integer | Não | Registros por página (máx: 100). Default: 20 |
Exemplo de uso:
“Liste os chats que estão aguardando atendimento”
transfer_chat
Transfere uma conversa para outro canal ou atendente.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| chat_id | string | Sim | ID do chat |
| channel | string | Sim | ID do canal de destino |
| attendant | string | Não | ID do atendente de destino |
| message | string | Não | Mensagem interna de contexto |
Exemplo de uso:
“Transfira o chat 01arz3ndektsv4rrffq69g5fav para o canal 01hxyz123abc456def789ghjkm”
Contatos
list_contacts
Lista os contatos.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| name | string | Não | Filtrar por nome |
| phone | string | Não | Filtrar por telefone |
| tag | string | Não | Filtrar por ID da tag |
| page | integer | Não | Página. Default: 1 |
| per_page | integer | Não | Registros por página (máx: 100). Default: 20 |
Exemplo de uso:
“Busque contatos com o nome João Silva”
get_contact
Busca um contato específico.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | string | Sim | ID do contato |
Exemplo de uso:
“Mostre os detalhes do contato 01hxyz123abc456def789ghjkm”
create_contact
Cria um novo contato.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| phone | string | Sim | Número de telefone com código do país |
| name | string | Não | Nome do contato |
| tags | array | Não | IDs das tags |
| customfields | object | Não | Campos personalizados |
Exemplo de uso:
“Crie um contato com o número 5511999999999 e nome João Silva”
update_contact
Atualiza um contato existente.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | string | Sim | ID do contato |
| name | string | Não | Nome do contato |
| tags | array | Não | IDs das tags |
| customfields | object | Não | Campos personalizados |
Exemplo de uso:
“Atualize o nome do contato 01hxyz123abc456def789ghjkm para João Silva”
verify_number
Verifica se um número existe no WhatsApp.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| phone | string | Sim | Número com código do país |
| channel | string | Sim | ID do canal WhatsApp |
Exemplo de uso:
“Verifique se o número 5511999999999 existe no WhatsApp”
Canais
list_channels
Lista os canais disponíveis.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| type | string | Não | Filtrar por tipo: whatsapp, instagram, etc |
| status | string | Não | Filtrar por status: connected, disconnected |
Exemplo de uso:
“Liste meus canais conectados”
Templates
list_templates
Lista os templates de mensagem disponíveis.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| channel | string | Não | Filtrar por ID do canal |
| status | string | Não | Filtrar por status: approved, pending, rejected |
| category | string | Não | Filtrar por categoria: marketing, utility, authentication |
Exemplo de uso:
“Liste os templates aprovados do canal 01arz3ndektsv4rrffq69g5fav”
Dicas de uso
Seja específico
Quanto mais detalhes você fornecer, melhor o assistente executará a tarefa:
❌ “Envie uma mensagem”
✅ “Envie uma mensagem para 5511999999999 usando o canal 01arz3ndektsv4rrffq69g5fav dizendo: Seu pedido foi enviado!”
Combine ferramentas
O assistente pode usar várias ferramentas em sequência:
“Busque o contato João Silva e mostre as últimas mensagens do chat”
Confirme antes de enviar
Para ações importantes, peça confirmação:
“Vou enviar uma mensagem para 100 contatos. Me mostre a prévia antes de enviar”