Guia de integração
n8n com o Mensageiro
A credencial OpenAI do n8n tem um campo Base URL. Troque o endereço e todo nó que usa essa credencial chama o Mensageiro.
1. Crie a credencial
Em Credentials, crie uma credencial do tipo OpenAI e preencha:
| Campo no n8n | Valor |
|---|---|
| API Key | SUA_CHAVE_MENSAGEIRO |
| Organization ID (optional) | em branco |
| Base URL | https://api.uplinkswitch.com/v1 |
| Add Custom Header | desligado |
Ao salvar, o n8n testa a credencial com GET /models na Base URL. A chave Mensageiro responde a esse teste.
2. Use a credencial nos nós
Use a credencial no nó OpenAI e no Chat OpenAI, o modelo do nó AI Agent. Escolha a credencial Mensageiro e informe o modelo pelo id, por exemplo claude-sonnet-5-5. Os ids estão na página de preços.
3. Um agente de WhatsApp em três nós
- Webhook: recebe a mensagem da Evolution API, da Z-API ou do Chatwoot.
- AI Agent com o Chat OpenAI na credencial Mensageiro: lê o texto do cliente e escreve a resposta.
- HTTP Request: envia a resposta pela API de envio da sua ferramenta de WhatsApp.
4. Uma credencial por cliente
Crie uma chave Mensageiro por cliente da agência e uma credencial n8n para cada chave. Cada chave tem o próprio limite mensal no console. No limite, a API responde 402 com monthly_limit_reached e só os fluxos daquele cliente param.