> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/configuracao/canais/whatsapp-waba-oficial-nativo.md). # WhatsApp WABA Oficial Nativo ### Visão geral O canal **WABA Oficial** é a integração do DigitalSac com a API oficial do WhatsApp Business. No sistema, esse canal aparece internamente principalmente com o tipo: ``` wabaoficial ``` Também existe o tipo: ``` waba ``` O tipo `waba` pode aparecer em estruturas relacionadas a provedores BSP ou integrações anteriores, enquanto o `wabaoficial` representa a integração oficial configurada diretamente com dados da API da Meta. *** ### Para que serve O canal WABA Oficial é usado para empresas que desejam operar WhatsApp através da API oficial do WhatsApp Business. Com ele, é possível: * Receber mensagens de clientes * Enviar mensagens pelo DigitalSac * Criar tickets automaticamente * Usar filas de atendimento * Enviar templates aprovados * Trabalhar com campanhas WABA * Usar webhooks oficiais * Enviar mídias * Utilizar mensagens interativas, quando disponíveis * Trabalhar com catálogo, quando configurado * Usar recursos oficiais da plataforma Meta *** ### Diferença entre WABA e WhatsApp por sessão O WABA Oficial é diferente de canais como WhatsApp Baileys ou WhatsMeow. ``` WhatsApp por sessão Normalmente depende de autenticação por sessão ou QR Code. WABA Oficial Utiliza dados oficiais da API do WhatsApp Business. ``` No WABA Oficial, a conexão é feita através de informações como token, número e conta empresarial. *** ### Dados de configuração No cadastro do canal WABA Oficial, normalmente são configurados dados como: * Nome do canal * Tipo do canal * Phone Number ID * Access Token * Business Account ID * Versão da API * App ID * Token de webhook * Fila ou fluxo vinculado, quando aplicável Exemplo: ``` Nome do canal: WABA Oficial Atendimento Tipo: WABA Oficial Uso: Atendimento oficial via WhatsApp Business API ``` *** ### Phone Number ID O **Phone Number ID** identifica o número de telefone dentro da estrutura da Meta. Ele é usado para enviar e receber mensagens através da API oficial. Esse dado deve ser configurado corretamente para que o canal funcione. *** ### Access Token O **Access Token** é a credencial usada para autenticar o envio de mensagens na API. Esse token é sensível e deve ser tratado como informação privada. Boas práticas: * Não compartilhar o token com usuários não autorizados * Não expor o token em prints públicos * Atualizar o token quando necessário * Solicitar suporte em caso de erro de autenticação *** ### Business Account ID O **Business Account ID** identifica a conta empresarial do WhatsApp Business. Esse dado é usado para relacionar o número ao ambiente empresarial configurado na Meta. *** ### Webhook do WABA Oficial O WABA Oficial trabalha com webhook para receber eventos e mensagens. O webhook é o endereço usado pela Meta para enviar informações ao DigitalSac. Exemplos de eventos recebidos: * Nova mensagem * Status de mensagem * Entrega * Leitura * Resposta do cliente * Interações com mensagens * Eventos de template No sistema, o canal pode exibir a URL de webhook gerada para configuração. *** ### Templates WABA O WABA Oficial permite o uso de templates aprovados. Templates são mensagens previamente aprovadas para envio ativo ao cliente, especialmente quando a conversa está fora da janela de atendimento. Exemplos de uso: * Confirmação de agendamento * Segunda via de boleto * Aviso de entrega * Notificação de suporte * Campanhas autorizadas * Mensagens de recuperação *** ### Campanhas WABA O DigitalSac possui recursos específicos para campanhas WABA. As campanhas WABA permitem enviar mensagens em massa usando templates aprovados. Exemplos de recursos relacionados: * Criação de campanha * Pausa de campanha * Retomada de campanha * Cancelamento de campanha * Relatório de campanha * Contatos da campanha * Etapas da campanha * Envio de templates Esse recurso deve respeitar as regras da Meta e as permissões do plano contratado. *** ### Janela de atendimento No WhatsApp Business API, o atendimento pode seguir regras de janela de conversa. De forma geral: ``` Quando o cliente envia uma mensagem, a empresa pode responder dentro da janela permitida. Fora da janela, pode ser necessário usar template aprovado. ``` O DigitalSac utiliza o canal WABA para organizar esse envio dentro dos recursos disponíveis. *** ### Mensagens interativas O canal WABA Oficial pode trabalhar com mensagens interativas, dependendo da configuração. Exemplos: * Botões * Listas * Respostas rápidas * Componentes de template * Catálogo, quando disponível Esses recursos ajudam a criar atendimentos mais guiados e organizados. *** ### Relação com filas O WABA Oficial pode ser usado com filas de atendimento. Exemplo: ``` Canal: WABA Oficial Fila: Atendimento ``` Quando uma mensagem chega pelo número WABA, o ticket pode ser direcionado para uma fila específica ou seguir um fluxo configurado. *** ### Relação com usuários Os usuários precisam ter permissão para atuar no canal e nas filas relacionadas. Exemplo: ``` Usuário: Carla Canal permitido: WABA Oficial Fila: Atendimento ``` Resultado: ``` Carla poderá responder tickets recebidos pelo canal WABA Oficial, conforme suas permissões. ``` *** ### Relação com automações O WABA Oficial pode ser usado com automações e fluxos de atendimento. Exemplo: ``` Cliente envia mensagem. Sistema cria ticket. Chatbot envia opções de atendimento. Cliente escolhe uma opção. Ticket é direcionado para a fila correta. Atendente assume o atendimento. ``` Também pode ser usado com campanhas, templates e mensagens automáticas. *** ### Diferença entre wabaoficial e waba No sistema existem dois tipos relacionados: ``` wabaoficial Canal WABA Oficial, usado com dados da API oficial da Meta. waba Tipo relacionado a integrações WABA anteriores ou provedores BSP, como estruturas baseadas em provedores externos. ``` Para documentação do usuário final, recomenda-se apresentar o canal principal como **WABA Oficial**. *** ### Quando usar WABA Oficial O WABA Oficial é indicado para empresas que precisam de: * Integração oficial com WhatsApp Business API * Uso de templates aprovados * Campanhas oficiais * Maior controle empresarial * Webhooks oficiais * Escalabilidade * Envio ativo dentro das regras da Meta * Relatórios e acompanhamento de status *** ### Boas práticas Recomenda-se: 1. Configurar corretamente os dados da conta Meta. 2. Usar tokens seguros e atualizados. 3. Validar o webhook após a configuração. 4. Criar templates claros e aprovados. 5. Respeitar as regras de envio ativo. 6. Usar campanhas apenas para contatos autorizados. 7. Organizar o canal por filas. 8. Definir usuários responsáveis. 9. Monitorar falhas de envio. 10. Acompanhar relatórios de campanhas WABA. *** ### Exemplo prático Uma empresa pode usar WABA Oficial para notificações e atendimento: ``` Canal: WABA Oficial Número: WhatsApp oficial da empresa Fila: Atendimento Geral ``` Uso: ``` Cliente envia mensagem. Ticket é criado no DigitalSac. Bot faz triagem inicial. Atendimento é enviado para a fila correta. Atendente responde pelo sistema. ``` Uso com campanha: ``` Empresa cria campanha WABA. Seleciona template aprovado. Seleciona contatos. Inicia envio. Acompanha o relatório da campanha. ``` *** ### Resumo O canal WABA Oficial conecta o DigitalSac à API oficial do WhatsApp Business. Ele é indicado para empresas que precisam de operação oficial, templates, campanhas e webhooks. Em resumo: ``` Tipo interno principal: wabaoficial Tipo relacionado: waba Canal: WhatsApp Business API Uso principal: atendimento oficial, templates e campanhas Configuração: Phone Number ID, Access Token, Business Account ID e webhook ```