Pular para o conteúdo

Academy

Para o administrador da conta › Para quem integra

Para quem integra

Chaves de API e conector MCP

Gerar a chave que autentica as integrações e ligar a sua conta a uma IA pelo conector MCP.

3 min de vídeo 12 imagens Painel do administrador

Aula gravada na plataforma real. O cursor, as legendas e o destaque existem só no vídeo.

Há duas formas de outro sistema conversar com a sua conta Heyoo. A chave de API é para quem programa — um site, um ERP, um script. O conector MCP é para quem quer que uma IA opere a conta, sem escrever código.

Área do desenvolvedor — A área do desenvolvedor.

A chave de API

Chaves de API — A chave, oculta por padrão.

Botão gerar chave — Gerar chave cria a primeira.

Aviso de segredo — A chave dá acesso à sua conta.

A chave nunca vai para o navegadorQuem tem a chave envia mensagens pela sua conta. Ela mora no servidor da sua integração, em variável de ambiente. Colada no JavaScript do seu site, ela fica visível para qualquer visitante.

Base URL — Base URL: o começo de toda chamada.

Endpoints disponíveis — Os endpoints disponíveis, com exemplo para copiar.

Trocar a chave

Gerar nova revoga a antiga na horaNão existe período de convivência. Toda integração que usava a chave antiga para de funcionar no mesmo instante — atualize primeiro onde ela está guardada, e só então confirme.

Ver o que aconteceu

Logs de uso — Chamadas bem-sucedidas e com falha, com o corpo do que foi enviado.

Comece o diagnóstico pelos logsQuando alguém diz a integração parou, os logs respondem em segundos se a chamada nem chegou (problema do lado dele), se chegou e falhou (o motivo aparece) ou se foi aceita (o problema é depois).

O conector MCP

MCP é o padrão que permite a uma IA usar ferramentas externas. Ligando a Heyoo, você pode pedir a ela — em português — que envie uma mensagem, consulte um template ou importe contatos.

Conector MCP — A tela Conectar à IA (MCP).

Conector hospedado — Conector hospedado: só uma URL, sem instalar nada.

Ferramentas do MCP — Ferramentas disponíveis — o que a IA pode fazer na conta.

Enviar texto pela Meta Cloud.
Enviar imagem, vídeo, áudio ou documento.
Enviar template aprovado (HSM).
Enviar pela instância QR conectada.
Listar templates do WhatsApp.
Importar contatos numa agenda.
Checar se a janela de 24h está aberta.
Consultar o status do canal e da API key.

Como adicionar — As instruções por cliente de IA.

Fora da Heyoo

O token do MCP é tão sensível quanto a chaveEle dá à IA o poder de mandar mensagem pela sua conta. Se você compartilhar a máquina ou o perfil do cliente de IA com outra pessoa, ela herda esse poder — gere um token novo quando isso acontecer.