Integrações com IA e MCP
Conecte seu assistente de IA à documentação oficial para criar integrações com a SendEasy usando endpoints, payloads e autenticação documentados.
Qual opção usar
| Opção | Quando usar | Endereço |
|---|---|---|
llms.txt | Dar à IA um índice com links para as referências relevantes | docs.sendeasy.app/llms.txt |
llms-full.txt | Carregar toda a documentação em português em uma leitura | docs.sendeasy.app/llms-full.txt |
| Markdown | Ler uma página específica sem o HTML da interface | Exemplo: API Pública |
| MCP | Permitir que o assistente busque e leia referências sob demanda | https://docs.sendeasy.app/mcp |
O índice e o conteúdo completo também existem em inglês (/en/llms.txt e /en/llms-full.txt) e espanhol (/es/llms.txt e /es/llms-full.txt). Para obter o Markdown de uma página, acrescente .md ao endereço. Nas páginas iniciais, use /index.md, /en/index.md ou /es/index.md.
Conectar por MCP
No seu cliente compatível com MCP remoto, adicione um servidor com estes parâmetros:
| Parâmetro | Valor |
|---|---|
| Nome | sendeasy-docs |
| URL | https://docs.sendeasy.app/mcp |
| Transporte | Streamable HTTP |
| Autenticação | Nenhuma |
O formato da configuração varia por cliente. Em clientes que aceitam mcpServers com url, a entrada é:
{
"mcpServers": {
"sendeasy-docs": {
"url": "https://docs.sendeasy.app/mcp"
}
}
}
O servidor oferece três ferramentas:
| Ferramenta | Uso |
|---|---|
search_docs | Busca por assunto. Recebe query, locale (pt, en, es) e limit (1 a 10). |
get_doc | Lê a página indicada por path. Para páginas grandes, continue com o nextOffset retornado, enviado como offset. |
list_docs | Lista páginas e descrições no idioma informado em locale. |
O idioma padrão é português. get_doc usa o idioma do caminho: por exemplo, /server/webhooks em português e /en/server/webhooks em inglês. Também há índices como recursos MCP: sendeasy://docs/pt, sendeasy://docs/en e sendeasy://docs/es.
Este MCP consulta documentação pública. Ele não envia mensagens, altera contatos ou acessa contas. Não informe tokens de clientes ao servidor de documentação. A execução da integração acontece no seu sistema, pela API da SendEasy, com as credenciais adequadas.
Exemplo de pedido ao assistente
Use a documentação oficial da SendEasy para criar uma integração em Node.js
que envie uma mensagem de WhatsApp quando um lead preencher meu formulário.
1. Busque a referência de /api/messages/send e leia a página completa.
2. Confirme o tipo de token, os campos obrigatórios e o formato do telefone.
3. Gere o código usando uma variável de ambiente para o token.
4. Trate erros e diferencie recebimento na fila de entrega final.
5. Cite as páginas usadas. Não invente endpoints ou campos.
Se o assistente não tiver MCP, peça para começar por https://docs.sendeasy.app/llms.txt e seguir os links Markdown relevantes.
Autenticação da integração
A URL base da API é https://backend.sendeasy.app. O header é Authorization: Bearer SEU_TOKEN, mas cada família de endpoints utiliza um tipo de token:
| Operação | Token | Referência |
|---|---|---|
Mensagens (/api/messages/send) | Token do canal | API Pública |
WABA (/api/v1/waba/*) | API Token | WABA API |
E-mail (/api/v1/email/*) | Token do canal de e-mail | E-mail API |
Bots (/api/v1/ai/*) | API Token | Bots API |
Integrações (/api/integration/*) | Token da integração | Custom |
Mantenha tokens no servidor da sua aplicação. Antes de implementar, consulte a Referência Técnica e o formato dos webhooks. Uma resposta de aceite ou enfileiramento não confirma a entrega final da mensagem.