Meta e agente vocale AI: contatti in target alle campagne

Con l'integrazione Meta, dopo ogni chiamata l'agente vocale AI manda al tuo pixel di Meta l'esito che conta per le campagne: se il contatto è in target, e se ha fissato un appuntamento. Meta riceve così, per ogni contatto, l'informazione che un modulo da solo non dà.

Questa guida spiega come collegare il pixel e attivarlo sugli agenti. Perché conviene, e come si inserisce nel giro dall'annuncio alla chiamata, è spiegato nella guida sui lead da Meta.

Quali eventi partono#

Dopo ogni chiamata di un agente con Meta attivo, in entrata o in uscita, Aptiva manda fino a due eventi attraverso la Conversions API, il canale con cui un sistema invia eventi a Meta dal server.

Le regole sono quattro:

1. Una volta per contatto. Ogni evento parte al più una volta per contatto e per connessione, anche se il contatto viene richiamato più volte.
2. Email e telefono come impronta. Meta li riceve trasformati in un'impronta SHA-256, la forma che chiede, e li confronta con i propri dati.
3. Il clic d'origine, quando c'è. Con l'evento viaggiano il codice del clic sull'annuncio e l'identificativo del lead di Meta, se il contatto li ha. Senza, Meta prova ad abbinare l'evento con email e telefono.
4. Nessun evento negativo, due eventi indipendenti. Un contatto fuori target non produce il QualifiedLead; una chiamata senza appuntamento non produce lo Schedule. Un appuntamento con un contatto fuori target produce lo Schedule.

«In target» è una valutazione dell'agente, cioè di un modello di intelligenza artificiale che applica il criterio scritto nel tuo script: a fine chiamata è istruito a segnare se il contatto è in target e se ha fissato un appuntamento.

Che cosa ti serve#

1. Un pixel di Meta, che Meta chiama anche dataset, con accesso a Gestione eventi.
2. Un token della Conversions API per quel pixel.
3. Lo script dell'agente, a cui aggiungere la frase che dice chi è in target.

L'ID del pixel e il token si trovano in Gestione eventi di Meta: apri il dataset, poi «Impostazioni» e la sezione «Conversions API», dove si genera il token.

Collegare Meta in quattro passi#

1. Aggiungi la connessione#

Nel pannello apri «Integrazioni», poi la scheda Meta. Nella sezione «Connessioni» clicca «Aggiungi connessione» e compila:

• Nome: un nome per riconoscerla, per esempio «Pixel del sito»;
• ID del pixel (dataset): il numero del pixel;
• Token di accesso: il token della Conversions API.

Aptiva conserva il token cifrato e non lo mostra più. Per cambiarlo usi «Modifica»: se lasci vuoto il campo del token, resta quello salvato.

Ingrandisci

Una connessione serve un pixel, e più agenti possono usare la stessa. Se hai più pixel, per esempio uno per marchio, crea una connessione per ciascuno.

2. Scrivi nello script chi è in target#

Con Meta attivo, lo script dell'agente deve dire quando un contatto è in target. È il criterio con cui l'agente decide se far partire il QualifiedLead. Scrivilo in modo verificabile in chiamata:

• «È in target chi vuole un preventivo per un impianto e ha una casa di proprietà.»
• «È in target chi cerca un appartamento in zona, con un budget sopra i 200.000 euro.»

Un criterio vago, come «è interessato», dà esiti incoerenti. Il pannello ricorda il requisito sopra l'editor dello script.

3. Attiva Meta sull'agente#

Nella sezione «Agenti» della pagina Meta clicca «Configura» accanto all'agente, scegli la connessione e salva. Poi clicca «Attiva». Ripeti per ogni agente che deve mandare eventi.

4. Controlla gli eventi in Meta#

Dopo le prime chiamate, in Gestione eventi di Meta compaiono gli eventi del server. Se non compaiono, controlla nel pannello lo stato della connessione: «Attiva» oppure «Rifiutata da Meta».

Collegare gli eventi agli annunci#

Meta lega un evento al suo annuncio se riceve, con l'evento, il codice del clic o l'identificativo del lead di Meta. Senza, l'evento parte lo stesso, e Meta prova ad abbinarlo con email e telefono. Il clic arriva ad Aptiva per una di tre strade, secondo il modulo che usi.

• Dal tuo sito, con le API. Meta aggiunge al link dell'annuncio il codice del clic, fbclid. Il tuo sito lo legge dall'indirizzo della pagina, lo conserva e lo manda ad Aptiva quando crea il lead, nella voce leadMetadata.attribution.
• Da Typeform. Aggiungi al modulo i campi nascosti, a partire da fbclid: Typeform li legge dall'indirizzo e li passa ad Aptiva da sé. I nomi sono nella guida su Typeform.
• Dal modulo istantaneo di Meta, con Zapier o le API. Il modulo istantaneo non apre un link e non ha un fbclid. Al suo posto si passa l'identificativo del lead di Meta, metaLeadId, nella stessa voce leadMetadata.attribution. L'esempio è nella guida su Zapier.

Le regole della voce leadMetadata.attribution, compresi i casi in cui Aptiva rifiuta la richiesta, sono nella guida sui lead da Meta.

Per le prime due strade conviene preparare anche l'annuncio. In Gestione inserzioni, nel campo «Parametri URL» dell'inserzione, incolla il testo che dà un nome a campagna e annuncio. Le etichette arrivano nell'indirizzo della pagina, e il sito o Typeform le passano ad Aptiva insieme al clic. Da solo questo testo non porta nulla ad Aptiva.

utm_source=meta&utm_medium=paid&utm_campaign={{campaign.name}}&utm_content={{ad.name}}

Questi dati non arrivano all'agente e non entrano nella conversazione.

Come usare gli eventi nelle campagne#

Gli eventi arrivano nel dataset del pixel, e da lì li usa chi gestisce le campagne. Secondo la documentazione di Meta, le conversioni personalizzate costruite su un evento si possono usare per ottimizzare le campagne e per definire pubblici personalizzati. Gli esempi d'uso sono nella guida sui lead da Meta. Aptiva fornisce il segnale; non promette un risultato sulle campagne.

Se qualcosa non va#

• La connessione è «Rifiutata da Meta». Meta ha rifiutato il token o l'ID del pixel. Correggili con «Modifica»: gli eventi aspettano e ripartono quando la connessione torna attiva. Meta non accetta eventi più vecchi di sette giorni: quelli in attesa da circa una settimana scadono e non partono più.
• «Attiva» non si accende sull'agente. L'agente non ha ancora una connessione salvata: scegli la connessione con «Configura» e salva.
• Non riesci a eliminare una connessione. È usata da agenti con Meta attivo: il pannello li elenca. Disattiva Meta su quegli agenti, poi elimina.
• Partono pochi QualifiedLead. Rileggi il criterio nello script: deve descrivere un caso che l'agente può riconoscere in chiamata.

I dati e il consenso#

Aptiva chiama i contatti che le indichi e presume che tu abbia il consenso di ciascuno: raccoglierlo spetta a te. Lo stesso vale per gli eventi: Aptiva manda a Meta ciò che riceve. Se le tue pagine usano il pixel o i cookie di Meta, il consenso dei visitatori lo chiedi tu, come richiede la normativa. I testi per i moduli sono nella guida sul consenso alle chiamate.

Prossimi passi#

1. Collega il modulo da cui arrivano i contatti: Typeform, Zapier o le API.
2. Leggi il giro completo nella guida sui lead da Meta.
3. Per gli altri strumenti guarda la mappa delle integrazioni.