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

WhatsApp Baileys Nativo

Visão geral

O canal WhatsApp Baileys é uma das formas de conexão do DigitalSac com o WhatsApp.

No sistema, esse canal aparece internamente com o tipo:

whatsapp

Ele utiliza uma conexão por sessão, normalmente vinculada a um número de WhatsApp, permitindo que a empresa envie e receba mensagens diretamente dentro do DigitalSac.

Esse canal é usado para operações de atendimento via WhatsApp, com suporte a tickets, contatos, filas, mensagens, automações e recursos operacionais da plataforma.


Para que serve

O canal WhatsApp Baileys permite que a empresa conecte um número de WhatsApp ao DigitalSac para centralizar os atendimentos.

Com ele, é possível:

  • Receber mensagens de clientes

  • Enviar mensagens pelo sistema

  • Criar tickets automaticamente

  • Trabalhar com filas de atendimento

  • Usar mensagens rápidas

  • Transferir atendimentos

  • Finalizar tickets

  • Importar contatos, quando configurado

  • Trabalhar com grupos, quando disponível

  • Usar automações e fluxos de atendimento

  • Acompanhar o status da conexão


Como o canal funciona

O WhatsApp Baileys funciona por sessão.

A empresa cria um canal no DigitalSac, escolhe o tipo WhatsApp e realiza a conexão do número.

Depois que o número está conectado, as mensagens recebidas por esse WhatsApp passam a entrar no sistema.

Fluxo básico:


Cadastro do canal

No cadastro do canal, normalmente são configurados dados como:

  • Nome do canal

  • Tipo do canal

  • Status

  • Canal padrão

  • Fila vinculada, quando aplicável

  • Fluxo de atendimento, quando aplicável

  • Configurações de importação

  • Configurações de mensagens

  • Recursos adicionais conforme o plano

Exemplo:


Canal padrão

O WhatsApp Baileys pode ser definido como canal padrão.

O canal padrão é usado como referência principal para algumas rotinas do sistema.

Importante: no DigitalSac, apenas canais do tipo WhatsApp tradicional podem ser definidos como padrão. Outros tipos de canal não devem assumir essa função.


Status da conexão

O canal possui status de conexão para indicar sua situação.

Exemplos de status:

  • Conectado

  • Desconectado

  • Aguardando QR Code

  • Abrindo conexão

  • Com erro

  • Em reconexão

Esses status ajudam o usuário a identificar se o número está pronto para uso.


QR Code

Em conexões do tipo WhatsApp Baileys, a conexão normalmente pode exigir leitura de QR Code.

O processo geralmente funciona assim:

Caso a sessão seja desconectada, pode ser necessário gerar um novo QR Code.


Relação com filas

O canal pode trabalhar junto com filas de atendimento.

Exemplo:

Nesse caso, os atendimentos recebidos pelo canal podem ser direcionados para a fila Comercial.

A fila define qual equipe irá atender o ticket.


Relação com usuários

Os usuários podem ter acesso a canais específicos.

Isso significa que um atendente pode visualizar apenas os canais liberados para ele.

Exemplo:

Resultado:


Recursos comuns

O canal WhatsApp Baileys pode ser usado com diversos recursos do sistema, como:

  • Atendimento individual

  • Histórico de mensagens

  • Envio de mídia

  • Mensagens rápidas

  • Transferência de tickets

  • Filas

  • Chatbot

  • Typebot, quando habilitado

  • Campanhas, quando permitido

  • Webhooks de status

  • Importação de contatos

  • Importação de mensagens, quando configurada


Importação de contatos

O canal pode permitir importação de contatos do WhatsApp.

Esse recurso ajuda a trazer contatos existentes para dentro do DigitalSac.

Durante a importação, o sistema pode aplicar:

  • Etiquetas

  • Carteiras

  • Regras de organização

  • Configurações de importação definidas pelo administrador


Importação de mensagens

O sistema também pode possuir configurações para importar mensagens antigas ou recentes.

Esse recurso deve ser usado com cuidado, principalmente em bases grandes, pois pode gerar muitos registros no sistema.

Exemplos de configuração:


Grupos de WhatsApp

O canal WhatsApp Baileys pode possuir recursos relacionados a grupos, dependendo da configuração da plataforma.

Exemplos de recursos possíveis:

  • Sincronização de grupos

  • Atendimento de mensagens de grupo

  • Configurações específicas para grupos

  • Regras de participação

  • Gerenciamento de contatos de grupo

O uso de grupos deve ser controlado conforme a necessidade da operação.


Quando usar o WhatsApp Baileys

Esse canal é indicado para empresas que desejam operar atendimento pelo WhatsApp usando conexão por sessão.

É comum em operações que precisam de:

  • Atendimento rápido

  • Centralização de conversas

  • Uso de filas

  • Controle por usuários

  • Histórico de tickets

  • Integração com automações

  • Uso de um ou mais números de WhatsApp


Boas práticas

Recomenda-se:

  1. Usar nomes claros para os canais.

  2. Criar um canal por número de WhatsApp.

  3. Evitar usar o mesmo número fora do processo oficial da empresa.

  4. Monitorar o status da conexão.

  5. Manter usuários vinculados corretamente às filas e canais.

  6. Revisar permissões de acesso.

  7. Evitar excesso de importação de mensagens sem necessidade.

  8. Usar filas para organizar o atendimento.

  9. Definir apenas um canal padrão quando necessário.

  10. Monitorar quedas ou reconexões.


Exemplo prático

Uma empresa pode configurar dois canais WhatsApp Baileys:

Nesse cenário:

  • Clientes de vendas entram pelo WhatsApp Comercial.

  • Clientes com dúvidas técnicas entram pelo WhatsApp Suporte.

  • Cada equipe visualiza apenas os atendimentos da sua área.


Resumo

O canal WhatsApp Baileys é usado para conectar números de WhatsApp ao DigitalSac por sessão.

Ele permite receber e enviar mensagens, criar tickets, organizar atendimentos em filas e controlar o acesso por usuários.

Em resumo:

Atualizado