Ir para o conteúdo
WACore api
Entrar
AtendimentoBotpress

Botpress no WhatsApp: canal customizado por API

O Botpress Cloud oferece canais prontos, mas o WhatsApp não oficial entra por webhook mais API. O fluxo é: mensagem chega no WACore, webhook para o conector, conector chama a API de conversas do Botpress e a resposta volta pela API do WACore.

Por que usar a API própria nesse caso

Você mantém o bot no Botpress (visual, versionado, com analytics) e usa o WACore só como canal — trocar de bot no futuro não afeta a sessão do WhatsApp.

Passo a passo

  1. Publique o bot e gere um Personal Access Token no Botpress.
  2. Crie o conector que recebe do WACore e chama POST /v1/chat/messages com userId igual ao telefone.
  3. Ouça a resposta (webhook do Botpress ou polling) e poste em /v1/messages/text.
  4. Guarde o conversationId por telefone para não abrir conversa nova a cada mensagem.

Exemplo de código

app.post('/wacore-hook', async (req, res) => {
  const { phone, text } = req.body.data;
  const r = await fetch('https://api.botpress.cloud/v1/chat/messages', {
    method: 'POST',
    headers: {
      authorization: `Bearer ${process.env.BOTPRESS_TOKEN}`,
      'x-bot-id': process.env.BOTPRESS_BOT_ID,
      'content-type': 'application/json',
    },
    body: JSON.stringify({
      conversationId: await convId(phone),
      userId: phone,
      type: 'text',
      payload: { type: 'text', text },
    }),
  });
  res.json({ ok: r.ok });
});

Duas dicas que evitam retrabalho

  • Use o telefone como userId: é o que dá continuidade ao contexto entre sessões.
  • Mande "digitando" antes de respostas com mais de duas linhas: o bot parece humano e o usuário espera.
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.

Ver planos