Entendendo a Arquitetura de Mensagens Rápidas

Semelhante aos e-mails, você pode precisar notificar seus clientes, seja enviando um link Mágico de Convite (Invites), um código multi-fator de Auth ou cobranças de PIX. Para isso, nosso Boilerplate está equipado com conectores avançados em apps/api/src/lib/whatsapp.

Como funciona na prática

Assim como você aprendeu no guia de e-mails, as mensagens instantâneas (WhatsApp / SMS) em nosso sistema funcionam conectadas por meio de uma Factory Inteligente. Você jamais enviará a requisição diretamente atada a um Axios => URL do Gateway; em vez disso, todos os modulos internos disparam usando a Message Provider Interface.

As estruturas já instaladas e portadas na aplicação incluem exemplos como as conexões:

• Evolution API (EvolutionProvider)
• Arara API (AraraProvider)

💡 O módulo lida com resiliência: você pode alterar ou construir instâncias novas herdando as chaves.

A Estrutura do Código

1. port (Interface Base): Uniformiza a estrutura (to: "numero", body: "mensagem") que qualquer SMS ou WhatsApp obedece.
2. whatsapp.factory.ts: Decide dinamicamente na hora da notificação para onde encaminhar a chamada baseando-se em decisões sistêmicas (seja por env ou status).
3. providers/: Cada plataforma de entrega se localiza aqui.

Dessa maneira, quando o sistema final estiver instanciando uma notificação pelo módulo de NotificationsService ou Invites, a fábrica providencia a camada sem que você precise refatorar as partes mais fundas de negócio SaaS (onde a lógica verdadeira reside).

✅ Em resumo: Deixe suas APIs Keys definidas nos ambientes .env corretos; nós orquestramos cada mensagem com as melhores práticas de encapsulamento Orientadas a Objetos com TypeScript!