Contents
hide
Introdução
Neste tutorial, criaremos uma página para lidar com webhooks de mensagens do WhatsApp recebidas usando Node.js
Dependências
para fins de desenvolvimento local, é necessário um serviço de tunelamento. Este exemplo usa o ngrok, você pode baixar o ngrok aqui: https://ngrok.com/download
Configure seu projeto
instale express e body-parser:
npm install express body-parser
Um exemplo simples de recebimento de mensagens do WhatsApp do Ultramsg
const express = require('express')
const bodyParser = require('body-parser')
const app = express()
const PORT = 3000
// Setup a webhook route
app.use(bodyParser.json())
app.post('/ultramsgwebhook', (req, res) => {
console.log(req.body) // print all response
//messageFrom=req.body['data']['from'] // sender number
//messageMsg=req.body['data']['body'] // Message text
res.status(200).end()
})
app.use(bodyParser.json())
app.listen(PORT, () => console.log(`🚀 Server running on port ${PORT}🚀 `))
Iniciar projeto ngrok e Node.js
Inicie o Ngrok para Windows:
ngrok http 3000
Inicie o Ngrok para Mac:
./ngrok http 3000
Inicie o projeto Nodejs:
node index.js
Defina o URL do Webhook para sua instância no ultramsg
Criamos um novo endpoint do webhook: http://your-ngrok.io.com/ultramsgwebhook para tratar da requisição, agora as urls do webhook devem ser colocadas na instância no Ultramsg e habilitar a opção Webhook on Received, conforme imagem a seguir:
EXEMPLO DE RESPOSTA JSON
{
event_type: 'message_received',
instanceId: '1150',
data: {
id: '[email protected]_3EB0FF54790702367270',
from: '[email protected]',
to: '[email protected]',
ack: '',
type: 'chat',
body: 'Hello, World!',
fromMe: false,
time: 1644957719
}
}
Parabéns. Você recebeu sua primeira mensagem do WhatsApp.
Tipos de webhooks para usar com a API do WhatsApp e Ultramsg
- webhook_message_received : notificações em webhooks quando a mensagem é recebida.
- webhook_message_create : notificações em webhooks quando a mensagem é criada.
- webhook_message_ack : notificações ack (mensagem entregue e mensagem visualizada) em webhooks.
- finalmente, você pode ver a documentação completa da API do Whatsapp e as perguntas frequentes .
- Como enviar uma mensagem pela API do WhatsApp usando o Node.js facilmente .
Você pode ver as etapas anteriores neste vídeo: