Conectar o WhatsApp ao CRM Bitrix24 em um número com Coexistência

Como o n8n conversa com o Bitrix24?

Por um webhook de entrada, que no Bitrix24 não é um receptor, e sim uma credencial. Você o cria nos recursos para desenvolvedores do Bitrix24, escolhe os escopos que ele pode usar e recebe uma URL com o endereço do seu portal, o id do usuário que o criou e um código secreto. Acrescentar o nome de um método a essa URL chama a API REST como esse usuário, com as permissões dele.

Assim, no n8n cada etapa do Bitrix24 é um nó HTTP Request que envia um POST para essa URL mais um método como crm.lead.add.json. Não há fluxo OAuth para concluir nem app para publicar. Dê ao webhook apenas o escopo de CRM e crie-o com um usuário cujas permissões cubram os leads e contatos que o workflow precisa enxergar, já que o Bitrix24 verifica o acesso como esse usuário.

Quais métodos do Bitrix24 o workflow chama?

Três, em ordem, depois que o nó Webhook do n8n recebe a mensagem da Meta.

crm.duplicate.findbycomm com o tipo PHONE e o número do remetente devolve os ids de leads, contatos e empresas que têm esse número. Essa é a busca certa porque pesquisa os três de uma vez e foi feita para comparar meios de contato, não um campo de texto.

Quando nada é encontrado, crm.lead.add cria um lead com o nome do perfil do WhatsApp como título e o número no campo de telefone. Em seguida, crm.timeline.comment.add grava o texto da mensagem como comentário no registro, recebendo ENTITY_TYPE, ENTITY_ID e COMMENT. O comentário aparece na linha do tempo do registro, ao lado de ligações e e-mails, onde o vendedor já costuma olhar.

POST https://yourcompany.bitrix24.com/rest/1/<secret>/crm.duplicate.findbycomm.json
{ "type": "PHONE", "values": ["14155550188"] }

POST .../crm.lead.add.json
{ "fields": { "TITLE": "WhatsApp: Maria", "PHONE": [{ "VALUE": "14155550188", "VALUE_TYPE": "MOBILE" }] } }

POST .../crm.timeline.comment.add.json
{ "fields": { "ENTITY_TYPE": "lead", "ENTITY_ID": 4211, "COMMENT": "do you have anything friday?" } }

Como o limite de taxa influencia o workflow?

O Bitrix24 mede as chamadas REST com um balde furado. Cada requisição soma ao contador, o contador diminui a uma taxa fixa por segundo e, quando passa de um limite, a próxima requisição recebe um 503 com QUERY_LIMIT_EXCEEDED. Nos planos Enterprise o contador diminui 5 por segundo, com limite de 250; em todos os outros planos diminui 2, com limite de 50.

Cada mensagem recebida custa duas ou três chamadas, então um fluxo constante e moderado nunca chega perto. Uma rajada chega: cinquenta clientes respondendo ao mesmo template em um minuto são até 150 chamadas. Configure os nós HTTP Request para repetir em caso de falha com uma espera curta e execute as execuções do workflow uma de cada vez, para que a rajada escoe para o Bitrix24 em vez de bater e voltar.

As respostas digitadas no celular chegam ao Bitrix24?

Podem chegar. Em um número com Coexistência, o app do WhatsApp Business continua funcionando e, quando alguém responde por ele, a Meta envia um eco da mensagem enviada para o mesmo destino de webhook, no campo smb_message_echoes.

Uma segunda ramificação do workflow trata esses ecos como as mensagens recebidas, com o comentário marcado como enviado. O registro passa a mostrar a conversa completa, com as falas do cliente e as respostas da loja em ordem.

As respostas que o próprio workflow envia pela Cloud API já estão em poder dele na hora do envio, então registre-as nesse momento em vez de esperar um webhook voltar.

Erros comuns

• Colar a URL do webhook de entrada em código do lado do cliente ou em um documento compartilhado. O segredo nela concede todos os escopos dados ao webhook.
• Criar o webhook com um usuário que não vê todos os leads. As buscas deixam registros de fora e o workflow cria duplicatas.
• Enviar uma rajada de chamadas sem repetição. O Bitrix24 responde 503 QUERY_LIMIT_EXCEEDED e essas mensagens nunca chegam à linha do tempo.

Perguntas frequentes

Continue lendo