Como conectar o WhatsApp ao Bitrix24

Para conectar o WhatsApp ao Bitrix24 você precisa de uma conta Bitrix24 com direitos de administrador, um número de WhatsApp e o aplicativo WASync do Bitrix24 Market. A configuração leva cerca de cinco minutos com um QR code, ou cerca de cinco minutos na janela de login da Meta para a WhatsApp Business API oficial.

Antes de começar

• Uma conta Bitrix24 com direitos de administrador. O WASync é instalado pelo Bitrix24 Market. Só um administrador pode instalar o aplicativo e adicionar conexões.
• Um número de WhatsApp. Tenha em mãos o celular que usa esse número.
• Um tipo de conexão. Os dois podem funcionar no mesmo portal.
  • WAPP (QR code), US$ 19/mês. Para um número que você já usa no WhatsApp ou no aplicativo WhatsApp Business. Ele é vinculado como o WhatsApp Web, então o celular precisa continuar ativo no WhatsApp.
  • WABA (WhatsApp Business API), US$ 29/mês. Para um número oficial da Meta, com modelos aprovados e sem celular para manter online. Você também precisa de uma conta do Facebook com acesso à sua empresa.

Os preços são por conexão, em USD, mais impostos quando aplicáveis. Uma conexão nova começa com um teste grátis de 7 dias, sem cartão. Se estiver em dúvida, leia WhatsApp QR ou Business API.

Passo 1: Instale o WASync pelo Bitrix24 Market

1. Entre no Bitrix24 como administrador.
2. Abra Market no menu à esquerda e procure por WASync.
3. Clique em Instalar e aceite as permissões solicitadas.
4. Abra o WASync no menu à esquerda. Ele abre na página Conexões.

Passo 2 (via QR): Vincule um número existente com um QR code

1. Na página Conexões, clique em Adicionar WAPP.
2. Digite um nome para a conexão, por exemplo "WhatsApp Vendas".
3. Escolha o Canal Aberto do Bitrix24 que vai receber as conversas, ou crie um novo na mesma lista.
4. Clique em Próximo. Um QR code aparece.
5. No celular, abra WhatsApp → Configurações → Dispositivos conectados → Conectar dispositivo.
6. Leia o QR code. O status muda para Conectado.

Passo 2 (via API): Conecte um número oficial pela Meta

1. Na página Conexões, clique em Adicionar WABA.
2. Confira a lista na janela. Você precisa de um número de telefone comercial que possa receber o código de verificação da Meta por SMS ou ligação.
3. Clique em Conectar com o Facebook.
4. Na janela da Meta, escolha ou crie a sua conta do WhatsApp Business e adicione o número.
5. Quando a janela da Meta terminar, feche-a. A conexão aparece na lista, e o WASync cria e vincula um Canal Aberto para ela.

A mesma janela explica o que fazer se o número estiver em uso no WhatsApp ou no aplicativo WhatsApp Business.

Passo 3: Escolha para onde vão as mensagens

1. O chat do CRM. Abra um lead, um negócio, um contato ou uma empresa e clique na aba WASync. Ela mostra a conversa de WhatsApp com o telefone daquele registro. Não precisa de configuração.
2. Um Canal Aberto. Cada conexão está vinculada a um Canal Aberto, então as conversas recebidas também chegam ao Contact Center do Bitrix24. Para trocar o canal, edite a conexão. Fila, horário de atendimento e respostas automáticas são definidos no próprio Canal Aberto, no Bitrix24.
3. Acesso. Na página Equipe, escolha quais funcionários podem usar cada número.

Passo 4: Teste

1. De outro celular, envie uma mensagem de WhatsApp para o número conectado.
2. No Bitrix24, confira se a conversa chega ao Canal Aberto.
3. Abra um lead, negócio ou contato que tenha o telefone do remetente e clique na aba WASync. A mensagem está lá.
4. Responda pela aba. A resposta chega ao outro celular.

Solução de problemas

• A mensagem está na aba WASync, mas não no Canal Aberto. Confira a coluna do Canal Aberto na página Conexões. O canal precisa continuar existindo no Contact Center e estar com o conector ativo. A lista completa está em mensagens de WhatsApp que não aparecem nos Canais Abertos.
• Uma conexão QR aparece como Desconectado. O WhatsApp desconecta os dispositivos conectados depois de muito tempo de inatividade no celular, ou quando alguém remove o dispositivo. Clique em Reconectar e leia o novo QR code. O histórico e a licença continuam na conexão.
• As mensagens param de sair, mas o status é Conectado. Use Reiniciar na conexão. A sessão é interrompida por cerca de 20 segundos.
• Uma mensagem da API falha depois de um dia de silêncio. Respostas livres só funcionam nas 24 horas seguintes à última mensagem do cliente. Depois disso, envie um modelo aprovado. Veja como enviar um modelo a partir de um fluxo de trabalho.
• Um cliente parou de escrever em um número da API. Um contato bloqueado não gera mensagem recebida nem erro. Confira a lista Usuários bloqueados desse número. Os detalhes estão em as regras de bloqueio.
• O segundo status mostra Não pronto. Clique nele. Ele lista quatro verificações (sessão, licença, a sua permissão, Canal Aberto), cada uma com um link para corrigir.

Limites que vale conhecer

• Números QR são para conversas individuais. Eles não são para envios em massa. O WhatsApp pode restringir um número que envia mensagens não solicitadas.
• No QR, o celular importa. O número precisa continuar ativo no WhatsApp, e um número só pode ter uma conexão ativa.
• Modelos na API. Fora da janela de 24 horas você só pode enviar modelos aprovados pela Meta. A Meta cobra as tarifas por mensagem à parte. Veja quanto custa a WhatsApp Business API.
• Ligações. Só funcionam em números da API. Ligações recebidas são gratuitas. Ligações feitas são cobradas pela Meta.
• Arquivos. O limite é de cerca de 16 MB por arquivo.
• Suporte. É só por escrito, em [email protected].

Comparação com as opções nativas do Bitrix24

O Bitrix24 tem seus próprios canais de WhatsApp no Contact Center. O Helpdesk do Bitrix24 descreve uma conexão por uma conta Twilio, disponível nos planos pagos, em que você precisa responder em até 24 horas. Ele também cita o Edna.io WhatsApp, que exige uma conta edna Pulse, e o Instant WhatsApp, um canal para o widget do site. Os três entregam as conversas em um Canal Aberto. O WASync acrescenta duas coisas: vincula por QR code um número que você já usa, e coloca o chat em uma aba do lead e do negócio.

Perguntas frequentes

Como conectar o WhatsApp ao Bitrix24 com um QR code?

No WASync, clique em Adicionar WAPP, dê um nome à conexão e escolha um Canal Aberto. Depois abra WhatsApp → Configurações → Dispositivos conectados → Conectar dispositivo no celular e leia o código. O status muda para Conectado.

O que é a WhatsApp Business API oficial para o Bitrix24?

É a plataforma da própria Meta para mensagens de empresas. Um número nela envia modelos aprovados pela Meta, pode escrever primeiro para um cliente e não depende de um celular. No WASync você conecta fazendo login com o Facebook.

Devo usar o QR ou a WhatsApp Business API?

Use o QR para responder clientes pelo número que você já tem. Use a API se precisar de modelos, de mensagens que iniciam uma conversa ou de ligações. Os dois tipos podem funcionar no mesmo portal.

Conectar o WhatsApp ao Bitrix24 é seguro — meu número pode ser banido?

A via QR usa o recurso Dispositivos conectados do próprio WhatsApp, o mesmo do WhatsApp Web. Mesmo assim, o WhatsApp pode restringir qualquer número que envie mensagens não solicitadas. A Business API é a via oficial da Meta para mensagens de empresas.

O que dá para fazer depois que o WhatsApp está conectado ao Bitrix24?

Sua equipe lê e responde as conversas de WhatsApp no lead, no negócio, no contato e na empresa, e nos Canais Abertos. Ela envia arquivos e áudios. As regras de automação estão incluídas nos dois planos, assim como as respostas de IA escritas com dados do CRM, com a sua própria chave de um provedor de IA.

Quanto custa conectar o WhatsApp ao Bitrix24?

O WAPP (QR) custa US$ 19/mês e o WABA (WhatsApp Business API) US$ 29/mês, por conexão, mais impostos quando aplicáveis. O complemento de API para desenvolvedores custa US$ 12/mês. Uma conexão nova começa com um teste grátis de 7 dias.