Collega WhatsApp a Activepieces su un numero Coexistence

Come colleghi un numero Coexistence ad Activepieces?

Crea la connessione WhatsApp Business in Activepieces con due valori: l'access token e l'id del WhatsApp Business Account. La dashboard di EasyCoexistence mostra entrambi per la connessione, e get_api_credentials li restituisce a un assistente. Le istruzioni del piece parlano di creare una Meta app e un system user, perché partono dal presupposto che tu non abbia né l'una né l'altro. Qui il numero è già connesso, quindi passa direttamente a incollare i valori.

Poi costruisci un flusso che parte dal trigger New Incoming Message, imposta su di esso un verify token a tua scelta e pubblica il flusso. Copia l'URL webhook del trigger nella destinazione webhook del numero in EasyCoexistence, con lo stesso verify token. Meta invia la richiesta di verifica, il trigger risponde e ogni messaggio al numero avvia un'esecuzione.

Perché l'app secret deve restare vuoto?

Perché il secret che firma queste consegne non è tuo da incollare. Meta firma ogni webhook con l'app secret dell'app che possiede la sottoscrizione, e su un numero connesso tramite EasyCoexistence quella è l'app EasyCoexistence, il cui secret non viene mai condiviso.

Il piece tratta il campo come opzionale. Se resta vuoto, i suoi trigger accettano le consegne così come arrivano. Se lo riempi con il secret di un'altra app, ogni consegna fallisce il controllo X-Hub-Signature-256 e viene ignorata in silenzio, il che sembra esattamente come se i messaggi non arrivassero mai.

Il verify token è ciò che tiene fuori gli estranei dall'handshake. Scegli un valore casuale lungo e tieni privato l'URL del trigger, perché è l'indirizzo che avvia il tuo flusso.

Cosa può fare un flusso quando arriva un messaggio?

Il trigger passa al flusso un messaggio appiattito: mittente, nome del profilo, id del messaggio, tipo, testo, eventuale id del media, risposte a pulsanti e liste, e l'id del numero di telefono che ha ricevuto. Da lì è un normale flusso Activepieces con gli altri piece, come un CRM, un foglio o un passaggio AI.

Le risposte usano lo stesso piece. Send Message invia testo libero e consegna solo entro 24 ore dall'ultimo messaggio del cliente. Send Template Message invia un template approvato, l'unica cosa che viene consegnata dopo quella finestra. Pulsanti interattivi, liste, media, posizione e reazioni sono azioni a sé.

Le istruzioni di Activepieces osservano che Meta accetta un solo URL di callback per app. Con le destinazioni per numero il limite è un URL per numero, quindi un flusso che deve gestire più tipi di evento dovrebbe ramificarsi al suo interno.

Le risposte scritte sul telefono arrivano al flusso?

Arrivano al webhook, ma non a questo trigger. Su un numero Coexistence Meta invia un'eco di ogni risposta scritta nell'app WhatsApp Business alla stessa destinazione, nel campo smb_message_echoes. Il trigger New Incoming Message del piece legge solo il campo messages e scarta tutto il resto.

Se ti servono nel flusso le risposte dal telefono, avvia il flusso con il piece Webhook generico di Activepieces, che accetta qualsiasi metodo HTTP, e rispondi al GET di verifica con un passaggio Return Response sul suo URL sincrono. Poi analizzi tu il payload grezzo, con entrambi i campi.

Per la maggior parte dei flussi il trigger del piece è la scelta più semplice: reagisce ai clienti, e le risposte del team restano visibili nell'app sul telefono.

Errori comuni

• Incollare un app secret nella connessione WhatsApp. Le consegne sono firmate con il secret dell'app EasyCoexistence, quindi ognuna viene ignorata.
• Impostare la destinazione prima di pubblicare il flusso. Meta verifica subito e un flusso non pubblicato non può rispondere.
• Aspettarsi che il trigger New Incoming Message veda le risposte scritte sul telefono. Legge solo il campo messages, non smb_message_echoes.

Domande frequenti

Continua a leggere