Collega WhatsApp ai contatti GoHighLevel su un numero Coexistence

Come arriva un messaggio WhatsApp a un contatto HighLevel?

Meta invia ogni messaggio ricevuto dal numero alla destinazione webhook che hai impostato, qui un nodo Webhook di n8n. Il workflow passa il numero del mittente e il nome del profilo WhatsApp al nodo HighLevel di n8n, la cui risorsa contatto ha un'operazione di creazione o aggiornamento: un nuovo mittente diventa un contatto, uno già noto viene trovato e non duplicato.

Una volta ottenuto l'id del contatto, un nodo HTTP Request invia il testo del messaggio a /contacts/{contactId}/notes. La nota compare nella scheda del contatto, dove chiunque la apra vede cosa ha scritto il cliente. Quando il messaggio richiede un seguito, il nodo HighLevel può anche creare un'attività sul contatto o un'opportunità in una pipeline, entrambe supportate direttamente.

Il team continua a rispondere dall'app WhatsApp Business per tutto il tempo.

Quale token deve usare il workflow?

Un token Private Integration. All'API v2 di HighLevel si accede con OAuth o con uno di questi token, mentre le vecchie chiavi API v1 sono arrivate a fine vita. Il token Private Integration si crea nelle impostazioni del sub-account, con i permessi che selezioni, e viaggia nell'header Authorization come qualsiasi token di accesso.

Non si rinnova da solo, il che va bene per un'automazione: continua a funzionare finché qualcuno non lo ruota. Quando lo ruoti, HighLevel mantiene validi insieme il vecchio e il nuovo token per sette giorni: è la finestra per incollare quello nuovo in n8n prima che il vecchio smetta di funzionare.

Spunta solo gli scope che servono al workflow: contatti, note e, se li usi, opportunità e attività. Se non trovi Private Integrations nelle impostazioni, HighLevel indica di attivarlo da Labs.

Come fa un solo workflow a servire più sub-account di clienti?

Instradando in base al numero che riceve. Ogni webhook inviato da Meta include il phone_number_id del numero aziendale che ha ricevuto il messaggio. Punta il numero di ogni cliente allo stesso webhook n8n, tieni una piccola tabella che associa ogni phone_number_id al sub-account di quel cliente e al suo token, e cerca il token all'inizio di ogni esecuzione.

Così c'è un solo workflow da mantenere per tutti i clienti, cosa che conta per un'agenzia più che per chiunque altro. Una correzione alla logica di abbinamento o al formato della nota arriva a tutti insieme.

I limiti di frequenza sono conteggiati per app e per sub-account, quindi i clienti non si consumano a vicenda la quota: ciascuno ha le sue 100 richieste ogni dieci secondi e 200.000 al giorno.

Le risposte scritte dal telefono arrivano a HighLevel?

Possono arrivare. Su un numero Coexistence l'app WhatsApp Business resta in uso e, quando qualcuno risponde da lì, Meta invia un'eco del messaggio in uscita alla stessa destinazione webhook, nel campo smb_message_echoes.

Aggiungi un ramo per queste eco e scrivile come note contrassegnate come inviate. La scheda del contatto contiene così in ordine le frasi del cliente e le risposte dell'azienda, che è ciò che un cliente si aspetta di vedere aprendo il proprio CRM.

Quando è il workflow stesso a inviare un messaggio tramite la Cloud API, per esempio un template approvato dopo la prenotazione di un appuntamento, scrivi la nota nel momento dell'invio. Il workflow ha già il testo e l'id del contatto.

Errori comuni

• Usare una chiave API v1. L'API v1 di HighLevel è arrivata a fine vita: l'API v2 richiede un token Private Integration o OAuth.
• Ruotare il token Private Integration senza aggiornare n8n entro i sette giorni di sovrapposizione. Ogni chiamata fallisce appena il vecchio token scade.
• Scrivere i messaggi di tutti i clienti con il token di un solo sub-account. Associa prima il phone_number_id al sub-account giusto, altrimenti i record finiscono nel cliente sbagliato.

Domande frequenti

Continua a leggere