Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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:

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:

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:

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:

Resultado:

Relação com automações

O WABA Oficial pode ser usado com automações e fluxos de atendimento.

Exemplo:

Também pode ser usado com campanhas, templates e mensagens automáticas.

Diferença entre wabaoficial e waba

No sistema existem dois tipos relacionados:

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:

Uso:

Uso com 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:

AnteriorWhatsapp Baileys (DigiAPI)
PróximoTelegram Nativo

Atualizado