WhatsApp'ı Coexistence numarasında Bitrix24 CRM'e bağlayın

n8n, Bitrix24 ile nasıl konuşur?

Gelen webhook üzerinden. Bitrix24'te bu bir alıcı değil, bir kimlik bilgisidir. Bitrix24 geliştirici kaynaklarında oluşturur, kullanabileceği kapsamları seçersiniz ve portal adresinizi, oluşturan kullanıcının kimliğini ve gizli bir kodu içeren bir URL alırsınız. Bu URL'nin sonuna bir yöntem adı eklediğinizde REST API, o kullanıcı adına ve onun yetkileriyle çağrılır.

Bu yüzden n8n'de her Bitrix24 adımı, bu URL'ye ve crm.lead.add.json gibi bir yönteme istek gönderen bir HTTP isteği düğümüdür. Tamamlanacak bir OAuth akışı ya da yayımlanacak bir uygulama yoktur. Webhook'a yalnızca CRM kapsamını verin ve iş akışının görmesi gereken potansiyel müşterileri ve kişileri kapsayan yetkilere sahip bir kullanıcıyla oluşturun, çünkü Bitrix24 erişimi o kullanıcı olarak denetler.

İş akışı hangi Bitrix24 yöntemlerini çağırır?

n8n Webhook düğümü mesajı Meta'dan aldıktan sonra sırasıyla üç yöntem çağrılır.

PHONE türü ve göndericinin numarasıyla crm.duplicate.findbycomm, bu numarayı taşıyan potansiyel müşterilerin, kişilerin ve şirketlerin kimliklerini döndürür. Doğru arama budur, çünkü üçünü birden tarar ve metin alanı yerine iletişim bilgisiyle eşleştirme için tasarlanmıştır.

Hiçbir şey dönmezse crm.lead.add, başlık olarak WhatsApp profil adını ve telefon alanında numarayı kullanarak potansiyel müşteri oluşturur. Ardından crm.timeline.comment.add, ENTITY_TYPE, ENTITY_ID ve COMMENT alanlarını alarak mesaj metnini kayda yorum olarak yazar. Yorum, satış temsilcisinin zaten baktığı yerde, aramaların ve e-postaların yanında zaman çizelgesinde görünür.

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?" } }

Hız sınırı iş akışını nasıl şekillendirir?

Bitrix24, REST çağrılarını sızıntılı kova algoritmasıyla ölçer. Her istek bir sayacı artırır, sayaç her saniye sabit bir hızla boşalır ve eşik aşıldığında sonraki istek QUERY_LIMIT_EXCEEDED ile 503 alır. Enterprise planlarında sayaç saniyede 5 boşalır ve eşik 250'dir; diğer tüm planlarda saniyede 2 boşalır ve eşik 50'dir.

Gelen her mesaj iki ya da üç çağrıya mal olur, bu yüzden düzenli akış sınıra yaklaşmaz. Ani yoğunluk yaklaşır: aynı şablona bir dakika içinde yanıt veren elli müşteri, 150'ye kadar çağrı demektir. HTTP isteği düğümlerini kısa bir bekleme ile hata durumunda yeniden deneyecek şekilde ayarlayın ve iş akışının çalışmalarını tek tek yürütün; böylece yoğunluk Bitrix24'e geri sekmeden yavaşça akar.

Telefondan yazılan yanıtlar Bitrix24'e ulaşır mı?

Ulaşabilir. Coexistence numarasında WhatsApp Business uygulaması çalışmaya devam eder ve biri oradan yanıt verdiğinde Meta, giden mesajın bir yansımasını aynı webhook hedefine smb_message_echoes alanı altında gönderir.

İş akışındaki ikinci bir dal bu yansımaları gelen mesajlarla aynı şekilde işler; yorum giden olarak işaretlenir. Böylece kayıtta müşterinin satırları ve işletmenin yanıtları sırasıyla görünen tam bir konuşma olur.

İş akışının Cloud API üzerinden kendisi gönderdiği yanıtlar çıkarken zaten iş akışının elindedir; geri dönecek bir webhook'u beklemek yerine onları gönderdiğiniz anda kaydedin.

Yaygın hatalar

• Gelen webhook URL'sini istemci tarafı koda veya paylaşılan bir belgeye yapıştırmak. İçindeki gizli kod, webhook'a verilen tüm kapsamlara erişim sağlar.
• Webhook'u tüm potansiyel müşterileri göremeyen bir kullanıcıyla oluşturmak. Aramalar kayıtları kaçırır ve iş akışı kopya kayıtlar oluşturur.
• Yeniden deneme olmadan art arda çağrı göndermek. Bitrix24 503 QUERY_LIMIT_EXCEEDED yanıtı verir ve bu mesajlar zaman çizelgesine hiç ulaşmaz.

Sık sorulan sorular

Okumaya devam edin