Invia le conversazioni WhatsApp a Salesforce da un numero Coexistence

Che aspetto ha il workflow n8n?

Quattro nodi in sequenza, più il ramo di verifica che ogni webhook di Meta richiede.

Un nodo Webhook riceve la POST che Meta invia per ogni messaggio. Un nodo Salesforce esegue una query SOQL per cercare un Lead o un Contact il cui telefono corrisponde al mittente. Un nodo IF si divide in base al risultato: se qualcosa è stato trovato, il workflow porta avanti l'id del record; altrimenti un nodo Salesforce crea un Lead con il nome del profilo preso dal payload. Un ultimo nodo Salesforce crea un Task su quel record, con il testo del messaggio nella descrizione e un oggetto che indica che si tratta di un messaggio WhatsApp.

Il ramo di verifica risponde alla GET di Meta con il valore di hub.challenge come corpo semplice. Senza questo ramo Meta non inizia mai a consegnare e il resto del workflow resta fermo.

Task o nota: quale conviene usare per il messaggio?

Un Task, per la maggior parte dei team, perché finisce nella timeline delle attività che i commerciali già leggono e può essere usato nei report. Imposta il suo stato su completato, così non compare come attività aperta, e dagli un oggetto che nomini il canale: filtrare le attività WhatsApp diventa una sola condizione.

L'operazione Add note del nodo n8n è adatta a un altro caso: un riepilogo invece di ogni singolo messaggio. Alcuni team fanno raccogliere al workflow i messaggi della giornata per ogni contatto e scrivono una sola nota la sera, così la timeline resta leggibile anche per un cliente che manda venti righe brevi.

Qualunque strada scegli, scrivi nel record l'id del messaggio WhatsApp. Meta ripete le consegne, e un workflow che controlla se esiste già un id prima di scrivere non registra mai lo stesso messaggio due volte.

Il team può ancora rispondere dal telefono e Salesforce lo vedrà?

Sì a entrambe le domande. Coexistence mantiene attiva l'app WhatsApp Business sullo stesso numero, quindi chi rispondeva ai clienti ieri continua a farlo. Quando risponde dall'app, Meta invia un'eco del messaggio in uscita alla stessa destinazione del webhook, nel campo smb_message_echoes.

Aggiungi al workflow un secondo percorso per queste eco e registrale come Task in uscita. Un commerciale che apre il lead vede così sia la domanda sia la risposta data dal negozio, in ordine, senza che nessuno copi a mano una chat.

Le risposte che il workflow invia da solo, tramite un nodo HTTP verso la Cloud API, vanno registrate nel momento dell'invio. Il workflow ha già a disposizione il testo e l'id del record.

Come si evitano i lead duplicati?

Cerca la corrispondenza su un numero di telefono normalizzato, non sul campo così com'è stato digitato. Meta invia il mittente come sole cifre con il prefisso internazionale e senza il segno più. I campi telefono di Salesforce contengono invece quello che ha inserito chi ha creato il record, con spazi, parentesi e trattini.

L'approccio affidabile è un campo di testo personalizzato con il numero in sole cifre, compilato dal workflow quando crea un lead e da un'operazione di backfill per i record esistenti. La query SOQL confronta poi quel campo per uguaglianza, in modo rapido ed esatto.

Controlla anche i contatti, non solo i lead. Un cliente già convertito è un Contact, e un workflow che cerca solo tra i lead crea un nuovo lead per ogni cliente esistente che scrive.

Errori comuni

• Cercare solo nell'oggetto Lead. I clienti esistenti sono Contact, e ognuno di loro che scrive diventa un lead duplicato.
• Registrare i messaggi come Task aperti. I commerciali ricevono un'attività da fare per ogni riga del cliente: imposta lo stato su completato quando li crei.
• Saltare il ramo GET di verifica nel workflow. Meta non conferma mai la destinazione e non viene consegnato nessun messaggio.

Domande frequenti

Continua a leggere