Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

Lähetä WhatsApp-keskustelut CRM:ään automaattisesti

Lähetä WhatsApp-keskustelut CRM:ään automaattisesti siten, että saapuvat viestit lähetetään allekirjoitettuina webhook-kutsuina taustajärjestelmääsi tai työnkulkutyökaluun. Etsi yhteystieto puhelinnumeron perusteella tai luo se, ja kirjaa viesti kyseisen yhteystiedon aktiviteetiksi. Käytä WhatsApp-viestin tunnusta aktiviteetin yksilöivänä avaimena, jolloin uudelleen lähetetty toimitus päivittää saman tietueen eikä luo toista.

easyCoexistence yhdistää WhatsApp Business -numerosi, jota pidät sovelluksessa, Metan Cloud API:n kautta Coexistencen avulla.

X-EC-Delivery

Välitetyn POST-pyynnön otsikko, jossa on toimitustunnus, sama jokaisella tämän toimituksen uudelleenyrityksellä.

About 33 hours

Seitsemän välitysyrityksen kokonaisaika, noin 1, 5, 30, 120, 360 ja 1 440 minuutin jälkeen.

1 attempt

Call my webhook -vaihe kutsuu URL-osoitettasi kerran; aikakatkaisu tai virhe keskeyttää suorituksen ja lähettää sinulle sähköpostin.

BSUID

Yrityskohtainen käyttäjätunnus, kuten US.13491208655302741918, lähetetään kentissä user_id ja from_user_id puhelinnumeron rinnalla tai sijaan.

30 days

Kuinka kauan automaation suoritusloki säilyttää laukaisevan viestin, vastauksen ja jokaisen vaiheen.

Mitkä tapahtumat pitäisi välittää CRM:ään?

Kolmenlaiset viestit muodostavat keskustelun Coexistence-numerolla, ja niitä kuljettavat kaksi reittiä. Numerokohtainen Forward URL lähettää asiakkaiden kirjoittamat viestit ja tiimisi WhatsApp Business -sovelluksessa kirjoittamat viestit Metan alkuperäisinä tapahtumina, ja ne yritetään uudelleen, kunnes CRM vastaa. Automaatioiden lähettämät vastaukset kulkevat Metalle API:n kautta, joka raportoi ne vain toimitustiloina ilman tekstiä. Jotta niiden sanat kirjautuvat, lopeta automaatio Call my webhook -vaiheeseen, jonka historia sisältää juuri lähetetyn vastauksen. Yksi päätepiste voi ottaa molemmat: X-EC-Event-otsikko kertoo vaiheen automation.step-arvolla ja välitykset Metan kenttänimellä.

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

Miten WhatsApp-lähettäjä yhdistetään CRM-yhteystietoon?

Puhelinnumeron perusteella normalisoituna. WhatsApp lähettää numeron maatunnuksella ja ilman plusmerkkiä, esimerkiksi 5511987654321, kentässä messages[].from välityksissä ja kentässä contact.wa_id webhook-vaiheessa. Ihmisten kirjoittamissa CRM-tietueissa on muotoa +55 11 98765-4321 tai (11) 98765-4321, joten säilytä erillinen ominaisuus pelkkinä numeroina ja hae sen perusteella. Jos mitään ei löydy, luo yhteystieto WhatsApp-profiilin nimellä ja numerolla.

Tallenna myös yrityskohtainen käyttäjätunnus. WhatsApp-käyttäjänimen omaava käyttäjä, joka ei ole ollut yhteydessä numeroosi 30 päivään, voi saapua vain BSUID:n kanssa kentissä from_user_id ja contacts[].user_id. Välitykset kantavat sen; webhook-vaihe kantaa puhelinnumeron.

Mitä kunkin CRM-tietueen pitäisi sisältää?

Yhteystieto tunnisteineen ja yksi aktiviteetti viestiä kohden, jossa on suunta, teksti, aika ja yksilöivä avain. Alla oleva kartta näyttää, missä kukin arvo on kummallakin reitillä. Välitysten viestiajat ovat Metan Unix-sekunteja; webhook-vaihe lähettää ISO-päivämääriä. Media saapuu välityksissä tyyppinä ja tunnuksena, webhook-vaiheessa paikanpitäjinä, kuten [image] ja kuvateksti, joten kirjaa lyhyt nimike sen sijaan, että yrittäisit tallentaa tiedoston.

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

Miten uudelleenyritykset estetään luomasta kaksoiskappaleita?

Vastaa nopeasti ja käytä yksilöivää avainta kaikessa. Välitys, jolle ei tule 2xx-vastausta 10 sekunnissa, yritetään uudelleen samalla X-EC-Delivery-tunnuksella enintään 7 kertaa, joten 12 sekuntia kestävä CRM-kutsu ajetaan kahdesti, ellei aktiviteettia päivitetä wamid-tunnuksella. Vastaa ensin 200 ja tee CRM-työ jonossa tai taustatyössä.

Webhook-vaihetta ei yritetä uudelleen, ja Metan omat toistetut toimitukset suodatetaan ennen automaation suoritusta, joten se kutsuu sinua enintään kerran viestiä kohden. Sen historiamerkinnöissä ei ole viesti-id:tä: yksilöi automaattiset vastaukset run_id:n ja vaiheen sijainnin avulla. Kokeilut Try it -toiminnosta saapuvat dry_run-arvolla true ja näytekontaktilla 15550000000; ohita ne, jotta testiajot eivät koskaan luo CRM-tietueita.

Miltä vastaanotin näyttää Node.js:ssä?

Yksi Express-reitti käsittelee molemmat tapahtumatyypit. Se lukee raakan rungon, valitsee salaisuuden X-EC-Event-otsikon perusteella, vahvistaa X-EC-Signature-otsikon, vastaa heti 200 ja siirtää työn taustafunktiolle. crm-objekti edustaa CRM:n API-asiakasta: yhteystiedon päivitys tai luonti pelkkien numeroiden puhelinnumeron perusteella ja aktiviteetin päivitys tai luonti sen yksilöivällä avaimella. Sama rakenne toimii n8n-työnkululle: Code-solmu allekirjoitukselle ja CRM:n solmut sen jälkeen.

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);

Voiko CRM päivittää liidin sen mukaan, mitä tekoäly oppi?

Kyllä, työnkulussasi. Call my webhook -vaiheen mukana saapuva keskustelu sisältää kysymykset, jotka tekoälysi esitti, ja asiakkaan vastaukset. Niinpä n8n:n mallisolmu tai kutsu backendissäsi voi poimia tarpeen, budjetin, ajoituksen tai sijainnin ja kirjoittaa ne liidin kenttiin ja siirtää sen vaihetta. Älä palauta vastausta, sillä asiakas on jo saanut tekoälyn viestin. Kun työnkulku päättää, että liidi kannattaa soittaa, se voi luoda tehtävän myyjälle tai hälyttää tiimin. Tai anna easyCoexistencen tehdä poiminta: agentti tai ”AI saves details” -vaihe kirjoittaa tarpeen, budjetin ja ajoituksen yhteystiedon kenttiin, ja ”Call an API” -vaihe voi lähettää ne CRM-järjestelmääsi {{contact.budget}}-tyylisillä tokeneilla rungossaan. Liidien kvalifiointisivu sisältää haastattelun ohjeet ja tämän asennuksen payloadin.

Näin otat sen käyttöön

  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.

Yleiset virheet

  • Haku CRM:stä vapaamuotoisen puhelinkentän perusteella. WhatsAppin pelkkien numeroiden muoto vastaa harvoin sitä, minkä ihminen kirjoitti, ja jokainen osumaton haku luo kaksoiskappaleen; hae normalisoidun pelkkien numeroiden ominaisuuden perusteella.
  • CRM:n kutsuminen ennen välityksen vastaamista. CRM, joka vie yli 10 sekuntia, saa easyCoexistencen yrittämään uudelleen, ja ilman päivitystä wamid-tunnuksella aktiviteetti kirjautuu kahdesti.
  • Pelkän välityksen kirjaaminen ja automaattisten vastausten odottaminen siinä. API-lähetykset palaavat tilatietoina ilman tekstiä; Call my webhook -vaihe vastauksen jälkeen kantaa sanat.
  • Testien päästäminen CRM:ään. Try it kutsuu todella URL-osoitettasi dry_run-arvolla true ja näytekontaktilla 15550000000; hylkää nämä tapahtumat ennen mitään päivitystä.
Näin teet tämän EasyCoexistencen avulla

Sen Forward URL välittää asiakasviestit ja puhelinvastaukset CRM:ään Metan alkuperäisinä tapahtumina, allekirjoitettuina numerokohtaisesti ja yritettyinä uudelleen noin 33 tuntia, kun CRM on alhaalla. Call my webhook -vaihe lisää automaattiset vastaukset. Välitys ja automaatiot sisältyvät pakettiin. Hinta US$ 9 numerolta kuukaudessa, laskien US$ 0.75:een asti lisättäessä numeroita; ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Mitkä CRM:t toimivat tämän kanssa?

Mikä tahansa CRM, jolla on API, joko omalla backendillä tai työnkulkutyökalulla, kuten n8n, Make tai Zapier, joissa on siihen solmut. HubSpotissa on Communications-objekti WhatsApp-kanavatyypillä, joka on tehty näiden viestien kirjaamiseen; HubSpot-sivu näyttää kutsun.

Voivatko tiimini vastata asiakkaille CRM:stä?

Vain jos CRM lähettää Metan Cloud API:n kautta numeron lähetyspäätepisteellä ja tunnuksella, jotka saadaan get_api_credentials-kutsulla: vapaa teksti 24 tunnin sisällä asiakkaan viimeisimmästä viestistä, sen jälkeen hyväksytty viestipohja. Nämä viestit näkyvät myös puhelimen sovelluksen keskustelussa.

Voiko vanhoja keskusteluja ladata CRM:ään?

Vain Metan historiatuonnin kautta, joka lähettää enintään 6 kuukauden yksi yhteen -keskustelut suoraan webhook-kohteeseen, joka on tallennettu 24 tunnin sisällä yhteyden muodostamisesta, kerran yhteyttä kohden. Numero, jonka asetus on ”Through easyCoexistence”, kirjaa tapahtumat välityksen alusta lähtien.

Mitä easyCoexistence säilyttää matkan varrella?

Välitetyt muutokset jonotetaan uudelleenyrityksiä varten ja poistetaan 7 päivän kuluttua. Numerolla, joka kulkee easyCoexistencen kautta, viestiteksti säilyy myös Conversations-näkymää ja tekoälyn kontekstia varten valitsemasi ajan, 30, 90 tai 365 päivää, ja ajolokit säilyvät 30 päivää. CRM pitää pysyvän tietueen.

Lue lisää

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeilu

Vahvistettu