Your AI Connector Docs

Atribuirea reclamelor de tip Click-to-WhatsApp

Dacă rulezi reclame Meta (Facebook/Instagram) de tip „Click to WhatsApp”, Your AI Connector îți poate spune din ce reclamă provine fiecare lead de pe WhatsApp — și îți poate oferi identificatorul de clic Meta de care ai nevoie pentru a raporta conversiile reale înapoi către Meta. Acest lucru permite campaniilor tale publicitare să se optimizeze pentru vânzări și rezervări reale, nu doar pentru „persoane care au început o conversație”.

Ce este capturat

Atunci când cineva atinge o reclamă „Click-to-WhatsApp” și trimite un mesaj afacerii tale, Meta atașează informații ascunse de referință la acel prim mesaj. Your AI Connector le citește automat și le stochează în profilul contactului. Fără configurare, fără setări — se întâmplă pur și simplu.

Informațiile capturate sunt stocate în contact sub formă de ad_referral și conțin:

Câmp Ce reprezintă
ctwa_clid Identificatorul de clic Meta. Aceasta este valoarea pe care o trimiți către Conversions API de la Meta pentru a atribui o conversie ulterioară exact acelui clic pe reclamă. Este gol pentru referințele din postări organice (vezi mai jos).
source_id ID-ul reclamei (sau postării) pe care a dat clic persoana.
source_type Fie ad (o reclamă plătită Click-to-WhatsApp), fie post (o postare organică pe Facebook/Instagram).
source_url Linkul asociat conținutului reclamei.
headline Textul titlului reclamei.
body Textul corpului reclamei.
channel Canalul pe care a sosit referința (în prezent, întotdeauna whatsapp).
captured_at Momentul în care referința a fost înregistrată pentru prima dată în contact.

Poți vedea acest lucru în panoul de vizualizare rapidă al unui contact dacă ai configurat un câmp personalizat pentru acesta, sau îl poți citi direct prin webhook-uri și API (vezi mai jos) — nu este separat ca un câmp etichetat propriu în tabelul Contacte.

Un lucru pe care payload-ul nu ți-l spune: pe care dintre numerele tale a venit conversația. Nu conține niciun id de pagină sau id de cont WhatsApp Business. Cu un singur număr, acest lucru nu contează; dacă rulezi mai multe numere pe diferite pagini de Facebook, va trebui să mapezi acest lucru de partea ta.

Pe ce conexiune funcționează

Acest lucru funcționează doar pe conexiunea oficială WhatsApp API. Meta livrează informațiile structurate de referință (inclusiv ctwa_clid) doar prin API-ul oficial WhatsApp Business. Conexiunea neoficială WhatsApp (web) nu le primește — nu există date despre click-urile pe reclame disponibile pe acea conexiune, din cauza modului în care este concepută.

Așadar, dacă atribuirea reclamelor de tip „closed-loop” este importantă pentru tine, rulează campaniile Click-to-WhatsApp printr-un număr conectat prin API-ul oficial WhatsApp.

Comportamentul la primul contact

Referința este capturată la primul mesaj pe care un contact îl trimite dintr-o reclamă. Dacă același contact dă clic ulterior pe o reclamă diferită și acel clic mai nou conține un identificator de clic, ad_referral stocat este actualizat, astfel încât ID-ul de clic să rămână curent pentru raportare. Referințele din postări organice (care nu au un ctwa_clid) nu suprascriu niciodată un ID de clic de reclamă plătită capturat anterior.

Introducerea datelor în Meta sau Google Ads

Your AI Connector captează datele de atribuire și le expune, dar nu trimite nativ conversiile către Meta sau Google pentru tine în prezent. Tu transmiți datele folosind webhook-uri și un instrument de automatizare.

Obiectul ad_referral este inclus în secțiunea contact a evenimentelor de webhook de ieșire (de exemplu, Mesaj Nou, Contact Reluat, Etichete Contact Actualizate și evenimente de analiză precum Programare Rezervată).

O configurare tipică de tip „closed-loop”:

  1. Un lead dă clic pe reclama ta „Click-to-WhatsApp” și îți trimite un mesaj. Your AI Connector înregistrează ad_referral (inclusiv ctwa_clid) în profilul contactului.
  2. Pe măsură ce lead-ul avansează — a rezervat un apel, a devenit client, a fost pierdut — marchezi acel rezultat (vezi „Gestionarea etapei din pâlnia de vânzări” mai jos).
  3. Un webhook este declanșat către instrumentul tău de automatizare (Zapier, Make sau Pabbly), transmițând atât rezultatul, cât și ctwa_clid-ul contactului.
  4. Instrumentul tău de automatizare apelează API-ul de Conversii Meta (folosind action_source = business_messaging și ctwa_clid) sau Google Ads (Import conversii offline / Conversii îmbunătățite pentru lead-uri) pentru a raporta conversia.

În acest fel, Meta și Google află ce anunțuri au produs rezultate reale și se optimizează în funcție de acestea.

Transmiterea etapei din pâlnie

Pentru a raporta o conversie, de obicei ai nevoie de două lucruri: ID-ul clic-ului (capturat automat) și rezultatul (pe care îl setezi tu). Cea mai sigură metodă de a atașa un rezultat este prin etichete, deoarece aplicarea unei etichete declanșează webhook-ul contact_tags_updated — iar acel payload include ad_referral al contactului. (Eliminarea unei etichete nu îl declanșează; vezi Contact Tags Updated.)

Poți aplica etichete automat:

  • Lasă agentul tău AI să eticheteze contactul în timpul conversației — configurează reguli de etichetare automată în setările agentului. Așa funcționează modelul „o pagină de destinație per reclamă → un mesaj de intrare → o etichetă” dacă dorești să etichetezi singur sursa.
  • Sau etichetează manual din secțiunea Chat-uri sau din pagina de Contacte.

Ori de câte ori o etichetă relevantă se modifică, webhook-ul se declanșează cu ID-ul de click atașat, gata de a fi transmis ca o conversie.

URL-ul webhook-ului este setat pe etichetă (tag) în sine, în fila Etichete a agentului (sau campaniei) de care aparține contactul — nu în Setări. Fiecare etichetă primește propriul URL și toate pot indica către același endpoint dacă dorești un singur loc în care să primești totul.

Citirea unui id de click pe care l-ai ratat deja

ad_referral este, de asemenea, returnat de API atât pe GET /v1/contacts/{id} (ca adReferral), cât și pe endpoint-ul listei de contacte (ca ad_referral), deci dacă receptorul tău a fost indisponibil sau dacă faci reconcilierea ulterior, poți citi id-ul de click înapoi în loc să aștepți următorul webhook. Contactele care au sosit înainte ca id-ul de click să fie înregistrat pe ele au null aici — valoarea poate fi capturată doar din mesajul primit, așa că nu există nimic de completat retroactiv.

Limitări

  • Doar conexiune oficială WhatsApp API (nu conexiunea web neoficială).
  • Nu există încă o integrare nativă, cu un singur clic, pentru Meta CAPI sau Google Ads — redirecționați datele prin Zapier/Make/Pabbly. Dacă doriți o integrare nativă, anunțați echipa de asistență la hi@youraiconnector.com.
  • Atribuirea este capturată începând de acum, din momentul în care aceasta este activă. Nu poate fi completată retroactiv pentru conversațiile care au avut loc înainte.

Pașii următori