Como conectar notificações do WhatsApp a canais do Slack sem serviços de terceiros

Integrar notificações do WhatsApp com canais do Slack pode melhorar significativamente a comunicação da equipe, permitindo atualizações em tempo real do WhatsApp diretamente no seu ambiente de trabalho do Slack. Embora serviços de terceiros como Zapier, Onlizer ou ChatArchitect ofereçam integrações perfeitas, algumas empresas preferem evitar dependências externas por motivos como privacidade de dados, custo ou necessidades de personalização. Este guia fornece uma abordagem detalhada e especializada para configurar notificações de eventos do WhatsApp em canais do Slack sem serviços de terceiros, utilizando a API do WhatsApp Business e a API do Slack. O foco é alcançar uma integração segura, escalável e personalizável, adaptada às necessidades do seu negócio.

‍

Por que integrar o WhatsApp com o Slack?

Antes de mergulhar na configuração técnica, vamos explorar por que essa integração é valiosa:

• Comunicação centralizada : consolide consultas de clientes, atualizações da equipe ou alertas críticos do WhatsApp em um único canal do Slack para melhor colaboração.
• Notificações em tempo real : receba instantaneamente mensagens do WhatsApp ou gatilhos de eventos (por exemplo, novas mensagens, atualizações de status) no Slack, reduzindo os tempos de resposta.
• Sem dependência de terceiros : evite custos recorrentes, preocupações com privacidade de dados ou limitações impostas por plataformas externas.
• Personalização : crie uma solução adaptada aos seus fluxos de trabalho específicos, como filtragem de mensagens de alta prioridade ou roteamento para canais específicos.

Este guia pressupõe que você tenha acesso administrativo a uma conta da API do WhatsApp Business, um espaço de trabalho do Slack e conhecimentos básicos de programação (por exemplo, Node.js ou Python). A solução utiliza webhooks, APIs e um servidor leve para gerenciar a integração.

Pré -requisitos

Para configurar notificações do WhatsApp no ​​Slack sem serviços de terceiros, você precisará:

1. Conta da API do WhatsApp Business:
   
   • Uma conta registrada do WhatsApp Business com acesso à API.
   • Um número de telefone comercial verificado.
   • Credenciais de API (chave de API, ID do número de telefone e token de acesso).
2. Espaço de trabalho do Slack:
   
   • Permissões administrativas ou de proprietário para criar e gerenciar aplicativos do Slack.
   • Um canal do Slack designado para notificações.
3. Ambiente de Desenvolvimento:
   
   • Um servidor ou plataforma de nuvem (por exemplo, AWS, Heroku ou um servidor local Node.js/Python) para hospedar a lógica de integração.
   • Familiaridade com APIs REST, webhooks e scripts básicos do lado do servidor.
4. Ferramentas:
   
   • Node.js ou Python para scripts.
   • Ngrok (para testes locais de webhooks).
   • cURL ou Postman para testes de API.

‍

Guia de integração passo a passo

Etapa 1: configurar o webhook da API do WhatsApp Business

A API do WhatsApp Business usa webhooks para notificar seu servidor sobre mensagens ou eventos recebidos. Você precisará configurar um endpoint de webhook para receber esses eventos.

1. Criar um endpoint de webhook:
   
   

Configure um servidor simples usando Node.js ou Python. Por exemplo, use Express.js (Node.js) para criar um endpoint:

‍

const express = require ( 'express' ); const app = express(); app.use(express.json());
 app.post( '/webhook' , ( req, res ) => {   console.log ( 'Webhook do WhatsApp recebido:' , req.body); res.status( 200 ).send( 'Webhook recebido' ); });
 app.listen( 3000 , () =>  console.log ( 'Servidor em execução na porta 3000' ));

‍

• Implante este servidor em uma URL pública (por exemplo, usando Heroku) ou use o Ngrok para testes locais para expor seu host local à Internet.
  
  

2. Configurar o WhatsApp Webhook:
   
   
   
   • Faça login no portal Meta para desenvolvedores (ou no painel do seu provedor de API do WhatsApp Business).
   • Navegue até as configurações da API do WhatsApp Business.
   • Adicione o URL do seu webhook (por exemplo, https://your-server.com/webhook).
   • Configure o webhook para escutar eventos como mensagens (para mensagens recebidas) ou status (para atualizações de entrega de mensagens).
     
     

Verifique o webhook implementando o ponto de extremidade de verificação (o Meta requer um ponto de extremidade GET para confirmar o URL do webhook).

app.get( '/webhook' , ( req, res ) => {   const verifyToken = 'SEU_TOKEN_DE_VERIFICAÇÃO' ;   if (req.query[ 'hub.mode' ] === 'assinar' && req.query[ 'hub.verify_token' ] === verifyToken) { res.status( 200 ).send(req.query[ 'hub.challenge' ]); } else { res.status( 403 ).send( 'Falha na verificação' ); } });

‍

3. Teste o Webhook:
   
   

Envie uma mensagem de teste para o seu número do WhatsApp Business e verifique se o seu servidor recebe o payload. O payload será algo como isto:

{   "object" : "whatsapp_business_account" ,   "entry" : [{     "changes" : [{       "value" : {         "messages" : [{           "from" : "1234567890" ,           "text" : { "body" : "Olá, isto é um teste!" } }] } }] }] }

‍

Etapa 2: Crie um aplicativo Slack para postar notificações

Para enviar eventos do WhatsApp para um canal do Slack, você precisará de um aplicativo Slack com permissões para publicar mensagens.

1. Crie um aplicativo Slack:
   
   
   
   • Acesse api.slack.com/apps e clique em “Criar novo aplicativo”.
   • Dê um nome ao seu aplicativo (por exemplo, “WhatsAppNotifier”) e selecione seu espaço de trabalho do Slack.
   • Em “Permissões”, adicione o escopo chat:write para permitir que o aplicativo publique mensagens.
2. Obtenha um token de bot:
   
   
   
   • Nas configurações do aplicativo Slack, navegue até “OAuth e permissões”.
   • Instale o aplicativo no seu espaço de trabalho e copie o “Bot User OAuth Token” (começa com xoxb-).
3. Teste de publicação no Slack:
   
   

Use o endpoint chat.postMessage da API do Slack para testar a publicação de uma mensagem. Por exemplo, em Node.js usando o pacote @slack/web-api:

const { WebClient } = require ( '@slack/web-api' ); const slack = new WebClient( 'YOUR_SLACK_BOT_TOKEN' );
  função  assíncrona postToSlack ( canal, mensagem ) {   await slack.chat.postMessage({     canal : canal,     texto : mensagem }); }
 postToSlack( '#whatsapp-notifications' , 'Mensagem de teste do WhatsApp!' );

‍

• Certifique-se de que o bot seja convidado para o canal de destino do Slack (por exemplo, /invite @WhatsAppNotifier).
  
  

Etapa 3: conectar os webhooks do WhatsApp ao Slack

Agora, combine o webhook do WhatsApp com a API do Slack para encaminhar notificações.

1. Analisar a carga útil do webhook do WhatsApp:
   
   

Modifique seu endpoint do webhook para extrair informações relevantes (por exemplo, número de telefone do remetente, texto da mensagem):

 

app.post( '/webhook' , async (req, res) => {   const payload = req.body;   if (payload.object === 'whatsapp_business_account' ) {     const messages = payload.entry[ 0 ].changes[ 0 ].value.messages;     if (messages && messages.length > 0 ) {       const message = messages[ 0 ];       const sender = message.from;       const text = message.text?.body || 'Mensagem não textual recebida' ;       const slackMessage = `Nova mensagem do WhatsApp de ${sender} : ${text} ` ;       await postToSlack( '#whatsapp-notifications' , slackMessage); } } res.status( 200 ).send( 'Webhook recebido' ); });

‍

2. Lidar com mensagens de mídia:
   
   

Se a mensagem do WhatsApp contiver mídia (por exemplo, imagens, vídeos), recupere o URL da mídia usando a API do WhatsApp e carregue-o no Slack:

const axios = require ( 'axios' );
  função  assíncrona handleMediaMessage ( mensagem, slackChannel ) {   const mediaId = message.image?.id || message.video?.id;   if (mediaId) {     const mediaUrl = await getMediaUrl(mediaId);     const mediaResponse = await axios.get(mediaUrl, {       cabeçalhos : { Autorização : `Portador do SEU_WHATSAPP_ACCESS_TOKEN` },       responseType : 'stream'
 });     await slack.files.upload({       canais : slackChannel,       arquivo : mediaResponse.data,       nome do arquivo : `whatsapp_media_ ${mediaId} `
 }); } }
  função  assíncrona getMediaUrl ( mediaId ) {   const response = await axios.get( `https://graph.facebook.com/v17.0/ ${mediaId} ` , {     cabeçalhos : { Autorização : `Portador do SEU_WHATSAPP_ACCESS_TOKEN` } });   return response.data.url; }

‍

3. Implantar e testar:
   
   
   
   • Implante seu servidor em uma plataforma de nuvem (por exemplo, AWS EC2, Heroku).
   • Envie mensagens de teste para seu número do WhatsApp Business e verifique se elas aparecem no canal designado do Slack.

Etapa 4: Aprimore a integração

Para tornar a integração mais robusta, considere estes recursos avançados:

• Filtragem de Mensagens : Adicione lógica para filtrar mensagens com base em palavras-chave, remetente ou prioridade. Por exemplo, encaminhe apenas mensagens com "urgente" para um canal específico do Slack.
• Comunicação bidirecional : permita que os usuários do Slack respondam às mensagens do WhatsApp enviando mensagens ao bot do Slack, que as encaminha por meio da API do WhatsApp.
• Tratamento de erros : implemente mecanismos de nova tentativa para chamadas de API com falha e registre erros em um canal dedicado do Slack.
• Segurança : Proteja seu ponto de extremidade do webhook com autenticação (por exemplo, verifique a assinatura do webhook do WhatsApp) e use variáveis ​​de ambiente para dados confidenciais, como tokens de API.

Etapa 5: Monitorar e Manter

• Monitore a integridade do webhook : verifique regularmente se o seu endpoint do webhook está recebendo eventos. Use ferramentas como o AWS CloudWatch ou um mecanismo de registro simples.
• Atualizar versões da API : As APIs do WhatsApp e do Slack podem ser atualizadas. Monitore o Meta para Desenvolvedores e a documentação da API do Slack para verificar alterações significativas.
• Dimensione conforme necessário : se o volume de mensagens aumentar, considere o balanceamento de carga ou a otimização do desempenho do seu servidor.

‍

Desafios e considerações

• Restrições da API do WhatsApp : A API do WhatsApp Business possui políticas rígidas, como aprovação de modelos de mensagens e limites de taxa. Garanta a conformidade para evitar a suspensão da conta.
• Limites de Taxa do Slack : A API do Slack tem limites de taxa (por exemplo, 1 mensagem por segundo por canal). Implemente enfileiramento para notificações de alto volume.
• Privacidade de dados : como você está lidando com dados de clientes, garanta a conformidade com o GDPR ou o CCPA protegendo os dados em trânsito e em repouso.
• Sobrecarga de manutenção : sem serviços de terceiros, você é responsável pelo tempo de atividade, atualizações e depuração do servidor.

‍

Conclusão

Integrar notificações do WhatsApp com canais do Slack sem serviços de terceiros é uma maneira poderosa de otimizar a comunicação, mantendo controle total sobre seus dados e fluxos de trabalho. Ao utilizar a API do WhatsApp Business e a API do Slack, você pode criar uma solução personalizada que atenda às necessidades da sua equipe. Embora essa abordagem exija conhecimento técnico e manutenção contínua, ela oferece flexibilidade e economia de custos incomparáveis ​​em comparação com plataformas de terceiros.

‍