mapa-integracoes

Mapa de Integracoes

WhatsApp / Baileys

Tipo: Engenharia reversa do WhatsApp Web (nao oficial)
Lib: @whiskeysockets/baileys
Protocolo: Signal Protocol (criptografia E2E)
Sessao: Armazenada no banco BaileysSessions

Fluxo de autenticacao

1. Criar sessao no backend → gera QR code
2. Escanear QR com celular → WhatsApp autentica
3. Backend salva credenciais Baileys no banco
4. Reconexao automatica nas proximas reinicializacoes

Problemas comuns

• PreKeyError / failed to decrypt → Signal state corrompido → Ressincronizar
• conflict: replaced → Dois workers tentando autenticar o mesmo numero
• Timed Out em fetchProps → Timeout de rede durante inicializacao

Meta / WABA (WhatsApp Business API)

Tipo: API oficial do WhatsApp (Meta Cloud API)
Versao: v19.0 (configuravel por sessao)
Autenticacao: Token de acesso Meta (bmToken)
PhoneNumberId: tokenAPI do canal

Funcionalidades

• Envio de templates aprovados pela Meta
• Chamadas de voz WABA (WebRTC)
• Quality rating do numero (Alta/Baixa/Risco)
• Upload de midia para headers de template

Endpoints Meta usados

GET  graph.facebook.com/{v}/{phoneNumberId}?fields=webrtc_calling
POST graph.facebook.com/{v}/{phoneNumberId}/messages (envio template)
POST graph.facebook.com/{v}/message_templates (criar template)

Gupshup

BSP (Business Solution Provider) para WhatsApp.
Templates tem aprovacao propria (nao Meta diretamente).
Chamadas: sendGupshupCallPermissionRequest, initiateGupshupCall.

Dialog360

Outro BSP para WhatsApp.
Chamadas: sendDialog360CallPermissionRequest, initiateDialog360Call.

Instagram / Messenger

Via Meta Graph API.
Webhooks configurados em configuracoes/meta.

RCS (Rich Communication Services)

Modulo criado por nos. Provedores:

• Infobip: POST /bulkRcs — API: completa.workbuscas.com (token do tenant)
• Sinch: POST /bulkRcsSinch
• Zenvia: POST /bulkRcsZenvia

Backend NAO implementado ainda — frontend pronto, aguardando backend.

SMS

Provedores:

• Comtele: POST /bulkSms
• ConectaStartup: POST /bulkSmsConecta
• BHI/Livson: POST /bulkSmsLivson

WaVoIP (VoIP via WhatsApp)

Widget JavaScript que se conecta ao servico WaVoIP. Acesso via window.wavoip.call.startCall(number, tokens). Token configurado por sessao baileys (wavoipToken).

WorkBuscas (Consulta CPF/Telefone)

API externa para lookup de dados pessoais BR.
Tokens nas rotas Next.js:

• Telefone: qdAIQiafgBVqhPSAvzQnVOxq
• CPF: fZffGIblJbPKVwegpyhRHxsb

Endpoint: https://completa.workbuscas.com/api?token=...&modulo=phone|cpf&consulta=...