Visão Geral

RouteIt é a API de mensageria WhatsApp do ecossistema lbdev. Ela expõe conectores WhatsApp (via Cloud API da Meta ou via socket/QR code), permite enviar e receber mensagens, configurar webhooks para eventos e consultar relatórios de uso.

Conceitos-chave

• Conector — uma conexão WhatsApp gerenciada pela API. Existem dois tipos: CLOUD (integrado à WhatsApp Cloud API da Meta) e SOCKET (conexão direta via QR code).
• Organização (orgId) — os endpoints v2 são escopados por organização (/v2/chatbridge/{orgId}/...), suportando múltiplos tenants. Os endpoints v1 (/v1/chatbridge/...) são a geração anterior, sem escopo de organização, mantidos por compatibilidade.
• Webhook — assinatura de eventos (mensagem recebida/enviada, status de conector, etc.) entregues por HTTP a uma URL configurada.
• Mensagem — texto, mídia (áudio, imagem, vídeo, documento) ou template, enviada ou recebida através de um conector.
• Permissão por endpoint — cada endpoint exige uma permission específica (ex.: connectors:read), indicada na referência de cada recurso.

Autenticação

RouteIt usa o mesmo fluxo OAuth2 client credentials das demais APIs do ecossistema lbdev. Veja o guia de autenticação para gerar uma service account e trocar a credencial por um access token.

Base URL

URLs de ambientes internos (dev/hom) não são expostas nesta documentação pública.

Recursos documentados

• Buscar connector
• Enviar mensagem
• Consultar relatório de mensagens