Testado em 31/10/2026

Como conectar o WhatsApp e o Telegram ao OpenBot com MCP

Deixe o seu agente do OpenBot ler e responder no WhatsApp e no Telegram, e achar as ferramentas na primeira tentativa.

Antes de pedir ao agente (cole isto nas instruções ou na skill do agente)

As ferramentas são felku_*. No OpenBot, elas aparecem com o nome que você deu ao servidor: se você chamar o servidor de Felku, elas ficam em tools.Felku.felku_*. Para ler mensagens, chame felku_read_new_messages. O agente só recebe conversas da lista de contatos; lista vazia quer dizer só o seu próprio número no WhatsApp e nada no Telegram. Grupos não chegam em felku_read_new_messages; um grupo liberado pelo dono é lido por felku_read_group_messages. Mande o next_cursor anterior no after, senão as mesmas mensagens voltam.

No nosso teste, sem esse parágrafo, o agente levou umas 15 tentativas até descobrir como chamar as ferramentas.

Passo a passo

1. Conecte o WhatsApp ou o Telegram no painel do Felku e ponha na lista de contatos quem o agente pode

atender. Mensagem de qualquer outra pessoa é descartada na chegada.

1. Ligue o OpenBot ao Felku, de um dos dois jeitos abaixo. O nome que você der ao servidor no OpenBot vira o

prefixo das ferramentas.

Por chave

• Crie uma chave em Agentes e chaves. Para um agente que só lê e resume, deixe marcadas só as caixas de

leitura (é o padrão): Ler mensagens e Ver status e limites ligadas, Enviar e agir desligada. Ele lê e não consegue enviar. A chave começa com fkc_ e aparece uma vez só.

• No OpenBot, adicione um servidor MCP remoto com a URL https://mcp.felku.com.br/mcp e o cabeçalho

Authorization: Bearer <sua chave>.

Depois

1. Cole o parágrafo acima nas instruções ou na skill do agente.

2. Peça ao agente: "mostre o status da minha conexão do Felku". Ele deve chamar felku_get_connection_status.

O que o agente pode e não pode

• Só lê e responde contatos da sua lista, em conversas um a um.

• Com uma chave só de leitura, não consegue enviar nada. Testamos a leitura pelo OpenBot; o envio pelo OpenBot

ainda não foi testado.

• Todo envio tem limites no servidor, iguais em todos os planos: poucas mensagens por hora num número

recém-conectado, no máximo 3 primeiras mensagens por dia (ou menos, se você escolher) e uma pausa se a conexão começar a falhar.

• A conexão do WhatsApp não é oficial (um dispositivo conectado, como o WhatsApp Web). O WhatsApp pode restringir

um número a qualquer momento; os limites diminuem esse risco, não eliminam. Use um número reserva.