Pular para o conteúdo principal

Módulo Flow (WhatsApp & Mensageria)

O módulo Flow é o coração das comunicações na QuettaCode. Ele abstrai a complexidade da API oficial do WhatsApp Business (Cloud API) e outros canais, oferecendo uma interface unificada e poderosa.

Funcionalidades Principais​

  • Multicanal: Suporte primário a WhatsApp, com arquitetura pronta para SMS, Email e Instagram.
  • Gestão de Templates (HSM): Criação, sincronização e envio de modelos aprovados pela Meta.
  • Caixa de Entrada Unificada: APIs para construir interfaces de chat (Inbox).
  • Automação: Webhooks robustos para integrar com Chatbots e CRMs.

Estrutura de Dados​

Channel (Canal)​

Representa uma conexão com um provedor (ex: um número de WhatsApp). Um Tenant pode ter múltiplos canais.

Contact (Contato)​

Uma pessoa ou entidade com quem você se comunica. O contato é único por Tenant e pode ter múltiplos identificadores (número de telefone, email).

Thread (Conversa)​

O histórico de mensagens entre um Canal e um Contato.

Message (Mensagem)​

A unidade atômica de comunicação. Pode ser texto, imagem, vídeo, documento, localização, template, etc.

Fluxo Básico de Integração​

  1. Conectar Canal: Use o endpoint de conexão (via QR Code ou OAuth da Meta) para registrar o número.
  2. Sincronizar Templates: Baixe os templates aprovados da sua conta WABA (WhatsApp Business Account).
  3. Receber Mensagens: Configure o Webhook para ouvir eventos message.received.
  4. Enviar Mensagens: Use a API /messages para responder ou iniciar conversas (lembrando da janela de 24h).