Your AI Connector Docs

Click-to-WhatsApp advertentie-attributie

Als je Meta (Facebook/Instagram) “Klik naar WhatsApp”-advertenties gebruikt, kan Your AI Connector je vertellen van welke advertentie elke WhatsApp-lead afkomstig is — en je de Meta-klik-ID geven die je nodig hebt om echte conversies terug te rapporteren aan Meta. Hierdoor kunnen je advertentiecampagnes optimaliseren voor daadwerkelijke verkopen en boekingen, in plaats van alleen voor “mensen die een chat zijn gestart.”

Voer je in plaats daarvan advertenties uit naar een pagina op je eigen website met een WhatsApp-knop? Zie Advertentieklik-attributie voor WhatsApp.

Wat wordt vastgelegd

Wanneer iemand op een Klik-naar-WhatsApp-advertentie tikt en je bedrijf een bericht stuurt, voegt Meta verborgen verwijzingsinformatie toe aan dat eerste bericht. Your AI Connector leest dit automatisch en slaat het op bij de contactpersoon. Geen installatie, geen configuratie — het gebeurt gewoon.

De vastgelegde informatie wordt opgeslagen bij de contactpersoon als ad_referral en bevat:

Veld Wat het is
ctwa_clid De Meta-klik-identificatie. Dit is de waarde die u naar de Conversions API van Meta stuurt om een downstream-conversie toe te wijzen aan de exacte advertentieklik. Leeg voor verwijzingen via organische berichten (zie hieronder).
source_id De ID van de advertentie (of het bericht) waarop de persoon heeft geklikt.
source_type Ofwel ad (een betaalde Click-to-WhatsApp-advertentie) of post (een organisch Facebook/Instagram-bericht).
source_url De link die bij de advertentie-inhoud hoort.
headline De koptekst van de advertentie.
body De hoofdtekst van de advertentie.
channel Het kanaal waar de verwijzing vandaan kwam: whatsapp, instagram of messenger.
captured_at Wanneer de verwijzing voor het eerst werd geregistreerd bij de contactpersoon.

Je kunt het zien zonder enige configuratie: de pagina van de contactpersoon toont een Came from ad-label onder hun naam (beweeg de muis erover voor de advertentiedetails), het contactpaneel naast de chat toont het ook, en de Activiteit van de contactpersoon begint met de advertentie-tik. Je kunt het ook uitlezen via webhooks en de API (zie hieronder). Het is geen kolom in de Contacten-tabel.

Eén ding dat de payload je niet vertelt: op welk van je nummers het gesprek binnenkwam. Er staat geen pagina-id of WhatsApp Business Account-id in. Bij een enkel nummer maakt dat niet uit; als je meerdere nummers op verschillende Facebook-pagina’s gebruikt, moet je dat aan jouw kant toewijzen.

Leads die binnenkomen zonder telefoonnummer

Sommige mensen die je een bericht sturen vanuit een advertentie, hebben hun telefoonnummer verborgen in WhatsApp. In dat geval geeft Meta een privé-id voor de persoon door in plaats van een nummer, en wordt het contact aangemaakt met een leeg telefoonveld. Dit is normaal. Antwoorden, AI-antwoorden en automatische follow-ups bereiken de persoon nog steeds, omdat Your AI Connector hen via dat id benadert.

Laat het telefoonveld leeg bij een dergelijk contact. Typ er niet je eigen zakelijke nummer in: een bericht kan niet vanaf een nummer naar zichzelf worden verzonden, waardoor de volgende automatische follow-up zou mislukken en het contact zou worden gepauzeerd. Your AI Connector weigert nu om een van je eigen gekoppelde nummers op te slaan als telefoonnummer van een contact. Als de persoon later zijn nummer deelt, of je opnieuw een bericht stuurt waarbij het nummer zichtbaar is, wordt dit automatisch ingevuld.

Voor welke verbinding dit werkt

Dit werkt alleen voor de officiële WhatsApp API-verbinding. Meta levert de gestructureerde verwijzingsinformatie (inclusief ctwa_clid) alleen via de officiële WhatsApp Business API. De niet-officiële WhatsApp (web)-verbinding ontvangt dit niet — er zijn geen advertentieklikgegevens beschikbaar op die verbinding, vanwege de manier waarop deze werkt.

Dus als closed-loop advertentie-attributie belangrijk voor je is, voer je Click-to-WhatsApp-campagnes dan uit via een nummer dat is verbonden via de officiële WhatsApp API.

Click-to-Instagram- en Click-to-Messenger-advertenties

Advertenties die een Instagram DM of een Messenger-chat openen, worden op dezelfde manier geregistreerd op de Facebook-pagina en het Instagram-account die u hebt gekoppeld met de kaart Instagram & Messenger. Wanneer iemand een chat start vanuit een van die advertenties, krijgt de contactpersoon een ad_referral met channel ingesteld op instagram of messenger, source_type ingesteld op ad en source_id ingesteld op de advertentie-ID. Dat geeft u de advertentie achter elke contactpersoon, zodat u de kosten per boeking per advertentie kunt berekenen.

Een paar verschillen met WhatsApp:

  • Er is geen ctwa_clid; dat veld is leeg. Meta geeft die klik-identificatie alleen uit voor WhatsApp.
  • headline is de titel van de advertentie wanneer Meta deze verstuurt, en source_url is de link naar de afbeelding of video van de advertentie, indien aanwezig. body is leeg.
  • Als de contactpersoon eerst via de ene advertentie kwam en later een chat start vanuit een andere advertentie, toont ad_referral de nieuwere advertentie.
  • Contacten uit Messenger-advertenties bevatten de advertentie vanaf 14 oktober 2026. Contacten die vóór die datum via een Messenger-advertentie kwamen, hebben geen ad_referral, omdat de advertentiegegevens toen niet werden vastgelegd en achteraf niet kunnen worden ingevuld.
  • Messenger-chats die starten door op de knop Aan de slag van de Pagina te tikken, worden niet vastgelegd. Verwijder de knop ‘Aan de slag’ van je Pagina (Meta Business Suite, Postvak IN-instellingen) zodat mensen de chat starten door te typen, waarna de advertentie bij hun eerste bericht wordt vastgelegd.

First-Touch-gedrag

De verwijzing wordt vastgelegd bij het eerste bericht dat een contactpersoon stuurt vanuit een advertentie. Als dezelfde contactpersoon later op een andere advertentie klikt en die nieuwere klik bevat een klik-ID, wordt de opgeslagen ad_referral vernieuwd, zodat de klik-ID actueel blijft voor rapportage. Verwijzingen via organische berichten (die geen ctwa_clid hebben) overschrijven nooit een eerder vastgelegde klik-ID van een betaalde advertentie.

De gegevens in Meta of Google Ads krijgen

Your AI Connector legt de attributiegegevens vast en stelt deze beschikbaar. Voor advertenties die mensen eerst naar je eigen website sturen, kan Your AI Connector resultaten voor je naar Meta sturen wanneer een tag wordt toegepast: zie Resultaten naar Meta sturen. Voor Click-to-WhatsApp-advertenties stuur je de gegevens door met behulp van webhooks en een automatiseringstool.

Het ad_referral-object is opgenomen in de contact-sectie van de uitgaande webhook-gebeurtenissen (bijvoorbeeld Nieuw bericht, Contact hervat, Contacttags bijgewerkt en analysegebeurtenissen zoals Afspraak geboekt).

Een typische closed-loop opzet:

  1. Een lead klikt op je Klik-naar-WhatsApp-advertentie en stuurt je een bericht. Your AI Connector registreert ad_referral (inclusief ctwa_clid) bij de contactpersoon.
  2. Naarmate de lead vordert — een gesprek geboekt, klant geworden, verloren — markeer je dat resultaat (zie “De trechterfase bijhouden” hieronder).
  3. Er wordt een webhook geactiveerd naar je automatiseringstool (Zapier, Make of Pabbly) die zowel het resultaat als de ctwa_clid van de contactpersoon bevat.
  4. Je automatiseringstool roept de Conversions API van Meta aan (met behulp van action_source = business_messaging en de ctwa_clid) of Google Ads (Offline conversie-import / Verbeterde conversies voor leads) om de conversie te rapporteren.

Op deze manier leren Meta en Google welke advertenties echte resultaten opleveren en optimaliseren ze daarop.

De trechterfase bijhouden

Om een conversie te rapporteren heb je meestal twee dingen nodig: de klik-id (automatisch vastgelegd) en het resultaat (dat je zelf instelt). De meest betrouwbare manier om een resultaat te koppelen is met tags, omdat het toepassen van een tag de contact_tags_updated webhook activeert — en die payload bevat de ad_referral van de contactpersoon. (Het verwijderen van een tag activeert deze niet; zie Contact Tags Updated.)

Je kunt tags automatisch toepassen:

  • Laat je AI-agent de contactpersoon taggen tijdens het gesprek — stel regels voor automatisch taggen in via de configuratie van de agent. Dit is hoe het “één landingspagina per advertentie → één welkomstbericht → één tag”-patroon werkt als je de bron zelf wilt labelen.
  • Of tag handmatig vanuit Chats of de Contacten-pagina.

Wanneer een relevante tag verandert, wordt de webhook geactiveerd met de bijgevoegde klik-id, klaar om door te sturen als conversie.

De webhook-URL wordt ingesteld op de tag zelf, in het tabblad Tags van de editor van de AI-agent waaraan de contactpersoon is toegewezen, niet in Instellingen. Elke tag krijgt zijn eigen URL, en ze kunnen allemaal naar hetzelfde eindpunt verwijzen als je alles op één plek wilt ontvangen.

Een click-id lezen die je al hebt gemist

ad_referral wordt ook door de API geretourneerd op zowel GET /v1/contacts/{id} (als adReferral) als het eindpunt voor de contactenlijst (als ad_referral), dus als je ontvanger offline was, of als je achteraf wilt reconciliëren, kun je de click-id teruglezen in plaats van te wachten op de volgende webhook. Contacten die arriveerden voordat de click-id bij hen werd geregistreerd, hebben hier null — de waarde kan alleen worden vastgelegd vanuit het inkomende bericht zelf, dus er is niets dat achteraf kan worden ingevuld.

Beperkingen

  • Alleen officiële WhatsApp API-verbinding (niet de niet-officiële webverbinding).
  • De ingebouwde functie Resultaten naar Meta sturen verstuurt de klikgegevens die door het website-script zijn vastgelegd; het verstuurt niet de ctwa_clid van Click-to-WhatsApp-advertenties. Voor die advertenties, en voor Google Ads, stuur je de gegevens door via Zapier/Make/Pabbly. Als je een native integratie wilt, laat het dan weten aan de ondersteuning via hi@youraiconnector.com.
  • Attributie wordt vanaf nu vastgelegd, vanaf het moment dat dit live is. Het kan niet met terugwerkende kracht worden toegepast op gesprekken die eerder hebben plaatsgevonden.

Volgende stappen