> 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-baileys-nativo.md). # 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: ``` Cliente envia mensagem para o WhatsApp da empresa. O DigitalSac recebe a mensagem. O sistema identifica ou cria o contato. Um ticket é criado ou atualizado. O atendimento aparece para os usuários autorizados. O atendente responde pelo DigitalSac. A resposta é enviada ao cliente pelo WhatsApp. ``` *** ### 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: ``` Nome do canal: WhatsApp Comercial Tipo: WhatsApp Uso: Atendimento da equipe comercial ``` *** ### 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: ``` O administrador cria o canal. O sistema gera um QR Code. O responsável lê o QR Code com o WhatsApp. A sessão é autenticada. O canal passa a receber e enviar mensagens. ``` 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: ``` Canal: WhatsApp Comercial Fila: Comercial ``` 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: ``` Usuário: Ana Canal permitido: WhatsApp Comercial Fila: Comercial ``` Resultado: ``` Ana poderá atuar nos atendimentos do WhatsApp Comercial, respeitando suas permissões e filas. ``` *** ### 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: ``` Importar mensagens antigas Importar mensagens recentes Fechar tickets após importação Importar mensagens de grupos ``` *** ### 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: ``` Canal: WhatsApp Comercial Fila: Comercial Usuários: Ana, Pedro Canal: WhatsApp Suporte Fila: Suporte Usuários: João, Maria ``` 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: ``` Tipo interno: whatsapp Canal: WhatsApp Baileys Uso principal: atendimento via WhatsApp por sessão Recurso importante: conexão por QR Code Organização: filas, usuários, permissões e tickets ```