Integração de Bitrix24 CRM e WhatsApp via Make.com

Este fluxo cria um contato em Bitrix24 CRM quando uma nova mensagem WhatsApp é recebida e o contato com esse número não existe em Bitrix24. O fluxo é baseado em Webhooks TimelinesAI , integração de Bitrix24 CRM com Make.com e API REST de Bitrix24 CRM.

Criar um novo contato em Bitrix24 CRM quando uma nova mensagem WhatsApp é recebida

1. Criar um novo cenário em Make.com
2. Adicionar um módulo Webhook personalizado. Os próximos passos requerem dados do webhook presentes. Certifique-se de que executou o módulo Webhook e tem dados no payload
3. Adicionar um novo módulo Pesquisar Contatos de Bitrix24: O objetivo deste passo é verificar se o contato já existe em Bitrix24 CRM ou não. A busca é feita usando o campo Número de Telefone. Para adicionar este módulo, clique no ícone + ao lado do módulo Webhooks existente > procure e selecione Bitrix24 > em seguida, selecione Pesquisar Contatos

• Filtro: selecione Telefone ; operador: igual . Clique no próximo campo vazio. Uma nova caixa aparecerá à direita com dados disponíveis do módulo Webhook. Encontre remetente > telefone . Você pode clicar no valor encontrado OU arrastá-lo para o campo vazio:

• Clique em OK
• Clique com o botão direito no módulo Pesquisar Contatos de Bitrix24 recém-criado e selecione Executar apenas este módulo > insira qualquer número de telefone > clique em OK. Isso pesquisa contatos em seu Bitrix24 CRM por número de telefone e retorna resultados sobre se existe um contato com esse número. Os próximos passos requerem dados de saída. Certifique-se de que executou o módulo Pesquisar Contatos de Bitrix24 e tem dados no payload:

6. Adicionar o primeiro Filtro: clique no ícone de chave inglesa entre o Roteador e o próximo módulo vazio > em seguida, clique em Configurar um filtro

• Nomeie seu filtro O contato não existe
• Condição: clique no campo. Uma nova caixa aparecerá à direita com dados disponíveis do módulo Pesquisar Contatos de Bitrix24. Encontre Número total de pacotes >. Você pode clicar no valor encontrado OU arrastá-lo para o campo vazio
• Operadores numéricos: selecione menor que e digite 1 no próximo campo:

7. Adicionar um novo módulo Criar Contato de Bitrix24: O objetivo deste passo é criar um contato se ele não foi encontrado pelo módulo de pesquisa. Para adicionar este novo módulo, clique no ícone + ao lado do filtro existente “O contato não existe” > procure e selecione Bitrix24 > em seguida, selecione Criar Contato

• Telefone: pode ser mapeado com mensagem: remetente: telefone do webhook TimelinesAI

• Outros campos: podem ser mapeados, deixados em branco ou ter dados personalizados conforme suas necessidades

Resultado final: Webhook TimelinesAI monitora mensagens WhatsApp de entrada > pesquisa em Bitrix24 CRM por número de telefone > se o contato não for encontrado > cria um novo contato:

Sincronizar novas mensagens WhatsApp em comentários de tarefas em Bitrix24 CRM

Este fluxo cria uma tarefa em Bitrix24 CRM quando uma nova mensagem WhatsApp é recebida, vincula a tarefa ao contato de Bitrix24 CRM correspondente e adiciona novas mensagens WhatsApp recebidas como comentários na tarefa. O fluxo é baseado em Webhooks TimelinesAI , integração de Bitrix24 CRM com Make.com e API REST de Bitrix24 CRM.

1. Completa primeiro os passos da seção Criar um novo contato em Bitrix24 CRM quando uma nova mensagem WhatsApp é recebida deste artigo. Você deve ter os seguintes módulos em seu cenário para prosseguir:

2. Adicionar um novo módulo Fazer uma Chamada de API: O objetivo deste módulo é criar uma tarefa em Bitrix24 CRM e vincular a tarefa ao contato de Bitrix24 CRM que foi criado anteriormente neste fluxo. Para adicionar um novo módulo: passe o mouse sobre o módulo existente Criar contato e clique em + para adicionar um novo módulo. Procure e selecione Bitrix24 > em seguida, selecione Fazer uma Chamada de API

2. Configurar o novo módulo Fazer uma Chamada de API:
Conexão: Clique no botão Adicionar e insira sua URL de Bitrix24 > clique em Salvar
URL: tasks.task.add
Método: POST
Headers: adicionar um novo header com chave = Content-Type e valor= application/json
Body: adicionar

{ "fields": {
"TITLE": "TimelinesAI_WhatsApp_messages",
"UF_CRM_TASK": ["C_YOUR_ID_HERE],
"ADD_IN_REPORT": "N",
"STATUS":"5",
"RESPONSIBLE_ID": "1"
}
}

Nota: detalhes de parâmetros desta solicitação estão disponíveis em https://training.bitrix24.com/rest_help/tasks/task/tasks/tasks_task_getFields.php

YOUR_ID_HERE deve ser substituído pelos dados de saída do seu próprio módulo Criar contato.

3. Salve suas alterações. Clique com o botão direito no módulo recém-criado e renomeie-o para Chamada de API: criar uma tarefa. É importante renomear os módulos adequadamente para evitar confusão à medida que você adiciona mais módulos Fazer uma Chamada de API.

4. Clique com o botão direito no módulo e clique em Executar apenas este módulo > insira o ID do contato do seu Bitrix24 CRM > clique em OK. Para encontrar o ID do contato em Bitrix24 CRM, abra a Lista de Contatos, selecione qualquer contato (preferencialmente um contato de teste) e observe a URL da página em que você desembarcou. Por exemplo, se a URL é https://XXXX.bitrix24.com/crm/contact/details/17/, o ID do contato é 17. Após executar o módulo, verifique a página do contato em Bitrix24 CRM para confirmar que a nova tarefa foi criada.

5. Adicionar um novo módulo Fazer uma Chamada de API: O objetivo deste passo é adicionar mensagens WhatsApp recebidas como comentários na tarefa de Bitrix24 CRM que você criou anteriormente no fluxo. Para adicionar o módulo: passe o mouse sobre o último módulo Chamada de API: criar uma tarefa e clique em + para adicionar um novo módulo. Procure e selecione Bitrix24 > em seguida, selecione Fazer uma Chamada de API

6. Configurar o novo módulo Fazer uma Chamada de API:

• Conexão: Clique no botão Adicionar e insira sua URL de Bitrix24 > clique em Salvar
• URL: task.commentitem.add
• Método: POST
• Headers: adicionar um novo header com chave = Content-Type e valor= application/json
• Body: adicionar

[YOUR_TASKID_HERE, {
"POST_MESSAGE": "YOUR_TIME_HERE message received: YOUR_MESSAGE_TEXT"
}
]

• YOUR_TASKID_HERE deve ser substituído pelos dados de saída do seu próprio módulo Chamada de API: criar uma tarefa.
• YOUR_TIME_HERE e YOUR_MESSAGE_TEXT devem ser substituídos pelos dados de saída do módulo webhook original. Você pode incluir dados adicionais no campo POST_MESSAGE do seu Webhook se necessário.

7. Salve suas alterações. Clique com o botão direito no módulo recém-criado e renomeie-o para Chamada de API: adicionar mensagem de WA como comentário na tarefa. É importante renomear os módulos adequadamente para evitar confusão à medida que você adiciona mais módulos Fazer uma Chamada de API

8. Clique com o botão direito no módulo e clique em Executar apenas este módulo > insira números aleatórios no campo “Timestamp” > insira o ID da tarefa de teste do seu Bitrix24 CRM > clique em OK. Para encontrar o ID da tarefa em Bitrix24 CRM, abra qualquer tarefa (preferencialmente uma de teste). Você pode encontrar a tarefa criada em Bitrix24 CRM quando executa os módulos anteriores e usá-la para teste. Observe a URL da página em que você desembarcou. Por exemplo, se a URL é https://XXX.bitrix24.com/company/personal/user/1/tasks/task/view/35/XXXX , 35 será o ID da tarefa. Insira o texto aleatório. Em modo de produção, a mensagem WhatsApp recebida se tornará o texto. Após executar o módulo, verifique a página da tarefa em Bitrix24 CRM para confirmar que o comentário foi adicionado à tarefa:

Resultado intermediário: Webhook monitora mensagens WhatsApp de entrada > pesquisa em Bitrix24 CRM por número de telefone > se o contato não for encontrado > cria um novo contato > cria uma tarefa especial e a vincula ao contato > adiciona mensagens WhatsApp recebidas como comentários na tarefa.

Até agora trabalhamos em uma ramificação onde o contato NÃO existia em Bitrix24 CRM e tivemos que criá-lo, depois criar uma tarefa e adicionar mensagens WhatsApp como comentários nessa tarefa. Nesta seção trabalharemos em uma nova ramificação do fluxo onde o contato já existe e precisamos apenas adicionar uma tarefa e comentários.

1. Adicionar um novo filtro. Clique no ícone de chave inglesa entre o Roteador e o próximo módulo vazio > em seguida, clique em Configurar um filtro (https://storage.crisp.chat/users/helpdesk/website/94268256ba492800/screen-shot-2024-01-16-at-1754_o6wobi.png)

• Nomeie seu filtro O contato existe
• Condição: clique no campo. Uma nova caixa aparecerá à direita com dados disponíveis do módulo Pesquisar Contatos de Bitrix24. Encontre Número total de pacotes >. Você pode clicar no valor encontrado OU arrastá-lo para o campo vazio
• Operadores numéricos: selecione maior ou igual e digite 1 no próximo campo

2. Adicionar um novo módulo Fazer uma Chamada de API: O objetivo deste passo é descobrir se o contato existente tem uma tarefa onde as mensagens WhatsApp são armazenadas ou não. Para adicionar um módulo clique no sinal + após o último filtro criado > procure e selecione Bitrix24 > em seguida, selecione Fazer uma Chamada de API

3. Configurar o novo módulo Fazer uma Chamada de API:

• Conexão: Clique no botão Adicionar e insira sua URL de Bitrix24 > clique em Salvar
• URL: tasks.task.list.json?order[CREATED_DATE]=desc&filter[UF_CRM_TASK]=C_YOUR_CONTACT_ID_HERE&[TITLE]=TimelinesAI_WhatsApp_Messages
• Método: GET
• Headers: adicionar um novo header com chave = Content-Type e valor= application/json
• Body: vazio
• YOUR_CONTACT_ID_HERE deve ser substituído pelos dados de saída do seu próprio módulo Pesquisar Contatos.

4. Salve suas alterações. Clique com o botão direito no módulo recém-criado e renomeie-o para Chamada de API: pesquisar tarefas. É importante renomear os módulos adequadamente para evitar confusão à medida que você adiciona mais módulos Fazer uma Chamada de API.

5. Clique com o botão direito no módulo e clique em Executar apenas este módulo > insira o ID do contato do seu Bitrix24 CRM > clique em OK. Para encontrar o ID do contato em Bitrix24 CRM, abra a Lista de Contatos, selecione qualquer contato (preferencialmente um contato de teste) e observe a URL da página em que você desembarcou. Por exemplo, se a URL é https://XXXX.bitrix24.com/crm/contact/details/17/, o ID do contato é 17.

6. Adicionar um novo módulo Roteador de Controle de Fluxo: O objetivo deste passo é dividir o fluxo em 2 ramificações adicionais: 1- se o módulo de pesquisa de tarefas encontrou a tarefa, 2- se o módulo de pesquisa não encontrou a tarefa. Para adicionar o módulo Roteador clique no ícone + ao lado do módulo existente Chamada de API: pesquisar tarefas > procure e selecione Controle de Fluxo > em seguida, selecione Roteador.

7. Adicionar um Filtro: clique no ícone de chave inglesa entre o Roteador e o próximo módulo vazio > em seguida, clique em Configurar um filtro!

• Nomeie seu filtro Se a tarefa existe
• Condição: clique no campo. Uma nova caixa aparecerá à direita com dados disponíveis do módulo Chamada de API: pesquisar tarefas. Encontre Body > Total >. Você pode clicar no valor encontrado OU arrastá-lo para o campo vazio
• Operadores numéricos: selecione igual a e digite 1 no próximo campo:

8. Adicionar um novo módulo Fazer uma Chamada de API: O objetivo deste passo é adicionar mensagens WhatsApp recebidas como comentários na tarefa de Bitrix24 CRM encontrada. Para adicionar este módulo clique no ícone + ao lado do filtro existente “Se a tarefa existe” > procure e selecione Bitrix24 > em seguida, selecione Fazer uma Chamada de API

9. Configurar o novo módulo Fazer uma Chamada de API:

• Conexão: Clique no botão Adicionar e insira sua URL de Bitrix24 > clique em Salvar
• URL: task.commentitem.add
• Método: POST
• Headers: adicionar um novo header com chave = Content-Type e valor= application/json
• Body: adicionar

[YOUR_TASKID_HERE, {
"POST_MESSAGE": "YOUR_TIME_HERE message received: YOUR_MESSAGE_TEXT"
}
]

• YOUR_TASKID_HERE deve ser substituído pelos dados de saída do seu módulo Chamada de API: pesquisar tarefas .
• YOUR_TIME_HERE e YOUR_MESSAGE_TEXT devem ser substituídos pelos dados de saída do módulo webhook original. Você pode incluir dados adicionais no campo POST_MESSAGE do seu Webhook se necessário.

10. Clique com o botão direito no módulo recém-criado e renomeie-o para “Chamada de API: adicionar mensagem de WA como comentário na tarefa”

11. Salve suas alterações e adicione um 2º Filtro:

• Nomeie seu filtro Se a tarefa não existe
• Condição: clique no campo. Uma nova caixa aparecerá à direita com dados disponíveis do módulo Chamada de API: pesquisar tarefas. Encontre Body > Total >. Você pode clicar no valor encontrado OU arrastá-lo para o campo vazio
• Operadores numéricos: selecione menor que e digite 1 no próximo campo:

11. Adicionar um novo módulo Fazer uma Chamada de API: O objetivo deste módulo é criar uma tarefa em Bitrix24 CRM e vincular a tarefa ao contato de Bitrix24 CRM existente. Para adicionar este módulo clique no ícone + ao lado do filtro existente “Se a tarefa não existe” > procure e selecione Bitrix24 > em seguida, selecione Fazer uma Chamada de API

12. Configurar o novo módulo Fazer uma Chamada de API:

• Conexão: Clique no botão Adicionar e insira sua URL de Bitrix24 > clique em Salvar
• URL: tasks.task.add
• Método: POST
• Headers: adicionar um novo header com chave = Content-Type e valor= application/json
• Body: adicionar

{ "fields": {
"TITLE": "TimelinesAI_WhatsApp_messages",
"UF_CRM_TASK": ["C_YOUR_ID_HERE],
"ADD_IN_REPORT": "N",
"STATUS":"5",
"RESPONSIBLE_ID": "1"