Por que usar a API própria nesse caso
Você usa o NLP do Google sem pagar por conversa de canal: o custo fica só na API do Dialogflow, que tem cota gratuita generosa.
Passo a passo
- Crie o agente no Dialogflow e baixe a chave da service account em JSON.
- No conector, mantenha uma sessão por telefone com o id igual ao número.
- Chame sessions.detectIntent passando a queryInput de texto.
- Poste fulfillmentText em /v1/messages/text; se vazio, mande a resposta padrão.
Exemplo de código
import dialogflow from '@google-cloud/dialogflow';
const client = new dialogflow.SessionsClient();
const project = process.env.GCP_PROJECT;
async function responder(phone, text) {
const session = `projects/${project}/agent/sessions/${phone}`;
const [res] = await client.detectIntent({
session,
queryInput: { text: { text, languageCode: 'pt-BR' } },
});
return res.queryResult?.fulfillmentText || 'Não entendi. Pode reformular?';
}
app.post('/wa-hook', async (req, res) => {
const { phone, text } = req.body.data;
const reply = await responder(phone, text);
await fetch('https://wacoreapi.zapboot.com/v1/messages/text', {
method: 'POST',
headers: { 'content-type': 'application/json', apikey: process.env.WACORE_KEY },
body: JSON.stringify({ instance: 'bot', number: phone, text: reply }),
});
res.sendStatus(200);
});
Duas dicas que evitam retrabalho
- Guarde contexto por telefone: o Dialogflow perde o fio quando a sessão muda de id.
- Fulfillment com chamada externa pode demorar — mande digitando antes para não parecer travado.
Contrato da API: todos os campos, códigos de erro e limites estão em /api. Se você precisa do mesmo endpoint em outra linguagem, a chamada é a mesma — muda só o cliente HTTP.
Como contratar
A contratação é sob consulta. Descreva o cenário (quantos números, volume e qual sistema integra) e receba a proposta com prazo de instalação e chave de API.