Giriş yapınÜcretsiz denemeyi başlatın
Meta Tech Provider

WhatsApp konuşmalarını CRM'inize otomatik gönderin

WhatsApp konuşmalarını otomatik olarak CRM'e göndermek için gelen mesajları imzalı webhook'lar olarak arka ucunuza ya da bir iş akışı aracına iletin; kişiyi telefon numarasına göre bulun ya da oluşturun ve mesajı o kişide bir etkinlik olarak kaydedin. Etkinliğin benzersiz anahtarı olarak WhatsApp mesaj kimliğini kullanın; böylece yeniden denenen bir teslimat ikinci bir kayıt açmak yerine aynı kaydı günceller.

easyCoexistence, uygulamada tuttuğunuz WhatsApp Business numarasını Coexistence aracılığıyla Meta Cloud API'ye bağlar.

X-EC-Delivery

Yönlendirilen bir POST isteğindeki başlık, teslimat kimliğini taşır ve aynı teslimatın her yeniden denemesinde değişmez.

About 33 hours

7 iletim denemesinin kapsadığı süre: yaklaşık 1, 5, 30, 120, 360 ve 1.440 dakika sonra.

1 attempt

Call my webhook adımı URL'nizi bir kez çağırır; zaman aşımı veya hata çalışmayı başarısız sayar ve size e-posta gönderir.

BSUID

İşletmeye özgü kullanıcı kimliği (örneğin US.13491208655302741918), telefon numarasının yanında ya da yerine user_id ve from_user_id alanlarında gönderilir.

30 days

Otomasyon çalıştırma kayıtlarının tetikleyen mesajı, yanıtı ve her adımı ne kadar süreyle sakladığı.

Hangi olaylar CRM'e ulaşmalı?

Bir Coexistence numarasındaki sohbet üç tür mesajdan oluşur ve bunları iki yol taşır. Numara başına ayarlanan Forward URL, müşterilerin yazdıklarını ve ekibinizin WhatsApp Business uygulamasında yazdıklarını, Meta'nın özgün olayları olarak iletir; CRM yanıt verene kadar yeniden denenir. Otomasyonların gönderdiği yanıtlar API üzerinden Meta'ya ulaşır ve bunları yalnızca metin içermeyen teslimat durumu olarak bildirir; bu yanıtların sözlerini kaydetmek için otomasyonu bir Call my webhook adımıyla bitirin, bu adımın geçmişinde çalıştırmanın az önce gönderdiği yanıt yer alır. Tek bir uç nokta ikisini de alabilir: X-EC-Event başlığı adım için automation.step, iletimler için ise Meta'nın alan adını okur.

Customer messagesForward URL, event messages, in value.messages
Replies typed on the phoneForward URL, event smb_message_echoes, in value.message_echoes
Automated repliesCall my webhook as the last step: history entries with direction out
Lead detailsSaved by an agent or an AI saves details step, or extracted by your workflow from the chat; see lead qualification

Bir WhatsApp göndereni CRM kişisiyle nasıl eşleştirirsiniz?

Telefon numarasıyla, normalleştirilmiş biçimde. WhatsApp, ülke kodlu ve artı işaretsiz rakamlar gönderir, örneğin 5511987654321; bu değer iletimlerde messages[].from alanında, webhook adımında ise contact.wa_id alanında yer alır. İnsanların girdiği CRM kayıtları +55 11 98765-4321 ya da (11) 98765-4321 biçimini tutar; bu yüzden yalnızca rakamlardan oluşan biçimi tutan özel bir alan ekleyin ve aramayı bu alan üzerinden yapın. Eşleşme bulunmazsa kişiyi WhatsApp profil adı ve numarayla oluşturun.

İşletmeye özgü kullanıcı kimliğini de saklayın. WhatsApp kullanıcı adı olan ve numaranızla 30 gündür iletişime geçmemiş bir kullanıcı, yalnızca from_user_id ve contacts[].user_id içinde BSUID ile gelebilir. İletimler bunu taşır; webhook adımı ise telefon numarasını taşır.

Her CRM kaydı neleri tutmalı?

Tanımlayıcılarıyla bir kişi ve her mesaj için yön, metin, zaman ile benzersiz anahtarı içeren birer etkinlik. Aşağıdaki harita her değerin iki yolda nerede durduğunu gösterir. İletimlerdeki mesaj zamanları Meta'dan gelen Unix saniyesidir; webhook adımı ISO tarihleri gönderir. İletimlerde medya tür ve kimlik olarak, webhook adımında ise [image] gibi yer tutucular ve açıklamayla gelir; bu nedenle dosyayı saklamaya çalışmak yerine kısa bir etiket kaydedin.

Forwarded event (value is Meta's)Call my webhook step
Contact phonemessages[].fromcontact.wa_id
Contact namecontacts[].profile.namecontact.name
BSUIDcontacts[].user_id, messages[].from_user_idNot sent
Activity texttext.body, or the media typemessage.text and history[].text
Directionmessages = in, smb_message_echoes = outhistory[].direction: in, out or echo
Timetimestamp, Unix secondsmessage.at and history[].at, ISO 8601
Unique keymessages[].id (wamid)message.id; run_id for history entries

Yeniden denemelerin kopya kayıt oluşturmasını nasıl önlersiniz?

Hızlı yanıt verin, sonra her şeyi anahtarla kaydedin. 10 saniye içinde 2xx almayan bir iletim, aynı X-EC-Delivery kimliğiyle en fazla 7 deneme olarak yeniden denenir; bu nedenle 12 saniye süren bir CRM çağrısı, etkinlik wamid üzerinde upsert edilmediği sürece iki kez çalışır. Önce 200 yanıtı döndürün ve CRM işini bir kuyrukta ya da arka plan işinde yapın.

Webhook adımı yeniden denenmez ve Meta'nın kendi tekrarlı teslimatları otomasyon çalışmadan önce süzülür; bu yüzden her mesaj için en fazla bir kez çağırır. Geçmiş girişlerinde mesaj kimliği bulunmaz: otomatik yanıtları run_id ile konumlarının birleşimi üzerinden anahtarlayın. Try it'ten gelen testler dry_run true ve örnek kişi 15550000000 ile gelir; bu test çalıştırmalarının hiçbir zaman CRM kaydı oluşturmaması için bunları atlayın.

Node.js'te alıcı nasıl görünür?

Tek bir Express rotası iki olay türünü de alır. Ham gövdeyi okur, gizli anahtarı X-EC-Event başlığına göre seçer, X-EC-Signature değerini doğrular, hemen 200 yanıtı verir ve işi arka plan fonksiyonuna devreder. crm nesnesi CRM'inizin API istemcisini temsil eder: kişi için yalnızca rakamlardan oluşan telefon numarasıyla upsert, etkinlik için ise benzersiz anahtarıyla upsert. Aynı yapı bir n8n iş akışında da çalışır; imza için bir Code düğümü ve ardından CRM'inizin düğümleri kullanılır.

Express receiver: forwards and Call my webhook steps into a CRM
import express from "express";
import crypto from "node:crypto";

const FORWARD_SECRET = process.env.EC_FORWARD_SECRET; // the number's, shown once with the Forward URL
const STEP_SECRET = process.env.EC_STEP_SECRET;       // the automation's Signing secret

function signed(req, secret) {
  const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(req.get("X-EC-Signature") || "");
  if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
  const mac = crypto.createHmac("sha256", secret).update(m[1] + "." + req.body).digest();
  return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}

const app = express();
app.post("/whatsapp/crm", express.text({ type: "application/json" }), (req, res) => {
  const kind = req.get("X-EC-Event"); // automation.step, or Meta's field name for a forward
  if (!signed(req, kind === "automation.step" ? STEP_SECRET : FORWARD_SECRET)) return res.status(401).end();
  res.json({}); // no reply field: nothing is sent to the customer
  handle(kind, JSON.parse(req.body)).catch(console.error);
});

async function handle(kind, body) {
  if (kind === "messages") {
    for (const m of body.value.messages ?? []) { // statuses are skipped
      const c = (body.value.contacts ?? []).find((x) => x.wa_id === m.from);
      const contact = await crm.upsertContact({ phone: m.from, bsuid: m.from_user_id, name: c?.profile?.name });
      await crm.upsertActivity({ key: m.id, contact, direction: "in", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
    }
  } else if (kind === "smb_message_echoes") {
    for (const m of body.value.message_echoes ?? []) {
      const contact = await crm.upsertContact({ phone: m.to, bsuid: m.to_user_id });
      await crm.upsertActivity({ key: m.id, contact, direction: "out", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
    }
  } else if (kind === "automation.step" && !body.dry_run) {
    const contact = await crm.upsertContact({ phone: body.contact.wa_id, name: body.contact.name });
    const sentAfter = body.history.filter((h) => h.direction === "out" && h.at >= body.message.at);
    for (const [i, h] of sentAfter.entries()) {
      await crm.upsertActivity({ key: body.run_id + ":" + i, contact, direction: "out", text: h.text, at: new Date(h.at) });
    }
  }
}

app.listen(3000);

CRM, yapay zekânın öğrendiklerinden lead'i güncelleyebilir mi?

Evet, iş akışınızda. Call my webhook adımıyla gelen sohbet, yapay zekânızın sorduğu soruları ve müşterinin yanıtlarını içerir; bu yüzden n8n'deki bir model düğümü ya da arka ucunuzdaki bir çağrı ihtiyacı, bütçeyi, zamanlamayı ya da konumu çıkarıp lead'in alanlarına yazabilir, ardından aşamasını değiştirebilir. Yanıt döndürmeyin, çünkü müşteri zaten yapay zekânın mesajına sahip. İş akışı bir lead'in aranmaya değer olduğuna karar verirse bir satış temsilcisi için görev oluşturabilir ya da ekibi uyarabilir. Ya da çıkarma işini easyCoexistence'a bırakın: bir ajan ya da bir "AI saves details" adımı ihtiyacı, bütçeyi ve zamanlamayı kişinin alanlarına yazar, bir Call an API adımı da bunları gövdesinde {{contact.budget}} biçimli token'larla CRM'inize gönderebilir. Lead niteleme sayfası bu kurulum için görüşme talimatlarını ve payload'u içerir.

Nasıl kurulur

  1. Send the number's messages through easyCoexistenceOn the number's page, the Where incoming messages go card must be set to Through easyCoexistence; choose it if it shows Straight to your system.
  2. Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
  3. Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
  4. Log automated repliesIn each automation that replies, add Call my webhook as the last step with the same URL, save, and copy that automation's Signing secret.
  5. Check one real conversationWrite to the number from another phone, let the automation answer, reply from the app, and confirm three activities on the contact: in, automated out and phone out.

Yaygın hatalar

  • Serbest metin telefon alanında CRM araması yapmak. WhatsApp'ın yalnızca rakamlardan oluşan biçimi, bir kişinin yazdığı numarayla nadiren eşleşir ve her kaçırılan eşleşme bir kopya kişi oluşturur; bunun yerine normalleştirilmiş, yalnızca rakamlardan oluşan bir alan üzerinde arama yapın.
  • İletimi yanıtlamadan önce CRM'i çağırmak. 10 saniyeden uzun süren bir CRM, easyCoexistence'ın yeniden denemesine yol açar; wamid üzerinde upsert olmadan etkinlik iki kez kaydedilir.
  • Yalnızca iletimi kaydedip otomatik yanıtların da orada olmasını beklemek. API gönderimleri metinsiz durum olarak geri döner; yanıttan sonra gelen bir Call my webhook adımı sözleri taşır.
  • Testlerin CRM'e ulaşmasına izin vermek. Try it, dry_run true ve örnek kişi 15550000000 ile URL'nizi gerçekten çağırır; bu olayları herhangi bir upsert'ten önce düşürün.
Bunu EasyCoexistence'la yapmak

Forward URL, müşteri mesajlarını ve telefon yanıtlarını Meta'nın özgün olayları olarak, numara başına imzalı biçimde CRM'inize iletir; CRM kapalıysa yaklaşık 33 saat boyunca yeniden dener. Call my webhook adımı ise otomatik yanıtları ekler. İletim ve otomasyonlar planın içinde yer alır. Numara başına aylık US$ 9'dan US$ 0,75'e kadar, numara ekledikçe düşen fiyatlarla; ilk 3 gün ücretsizdir.

Sık sorulan sorular

Hangi CRM'ler bunu destekler?

Kendi arka ucunuzdan ya da n8n, Make veya Zapier gibi, bunun için düğümleri olan bir iş akışı aracından API'si olan her CRM ile çalışır. HubSpot'ta bu mesajları kaydetmek için tasarlanmış, WhatsApp kanal türüne sahip bir Communications nesnesi vardır; HubSpot sayfası çağrıyı gösterir.

Ekibim CRM'den müşterilere yanıt verebilir mi?

Yalnızca CRM, Meta'nın Cloud API'si üzerinden, numaranın gönderim uç noktasını ve get_api_credentials ile alınan token'ı kullanarak gönderiyorsa: müşterinin son mesajından sonraki 24 saat içinde serbest metin, sonrasında onaylı bir şablon. Bu mesajlar telefondaki uygulamanın sohbet akışında da görünür.

Geçmiş konuşmalar CRM'e yüklenebilir mi?

Yalnızca Meta'nın geçmiş içe aktarımı yoluyla; bu da bağlandıktan sonraki 24 saat içinde kaydedilmiş doğrudan bir webhook hedefine, bağlantı başına bir kez, birebir sohbetlerin en fazla 6 aylığını gönderir. "easyCoexistence üzerinden" olarak ayarlanmış bir numara, iletim başladığı andan itibaren kayıt tutar.

easyCoexistence süreç boyunca neleri tutar?

İletilen değişiklikler yeniden denemeler için kuyruğa alınır ve 7 gün sonra kaldırılır. easyCoexistence üzerinden geçen bir numarada mesaj metni ayrıca Konuşmalar ve yapay zekâ bağlamı için seçtiğiniz süre boyunca, 30, 90 ya da 365 gün, kalır; çalıştırma kayıtları 30 gün tutulur. Kalıcı kaydı CRM tutar.

Okumaya devam edin

Başlamaya hazır mısınız?

WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.

Ücretsiz denemeyi başlatın

Doğrulama tarihi