1. Controllare la connessione
Leggere il badge di stato
Un badge verde Connected significa che il token OAuth è valido. Un banner rosso Reconnect significa che il token è stato revocato o è scaduto.
Cause comuni di una connessione HubSpot non funzionante:
- L’utente HubSpot che ha autorizzato Flowella è stato rimosso dal portale.
- HubSpot ha ruotato il token perché non era stato usato di recente.
- Un superamministratore ha disattivato l’integrazione di Flowella nelle impostazioni dell’app di HubSpot.
2. Gli invii di moduli non vengono visualizzati in HubSpot
Se un contatto completa un modulo WhatsApp Flow, non è possibile vedere l’invio in HubSpot:Disadattamento della mappatura dei campi
Il flusso potrebbe includere un campo che non corrisponde a una proprietà HubSpot di tipo compatibile. Aprire il modulo nella pagina Forms ed esaminare la mappatura di ciascun campo.Il campo richiesto è vuoto
Se un campo del modulo HubSpot è contrassegnato come obbligatorio e WhatsApp Flow ha permesso all’utente di saltarlo, l’invio verrà rifiutato da HubSpot. Rendere il campo facoltativo in HubSpot o obbligatorio nel flusso.Formato del numero di telefono
HubSpot è rigoroso sul formato del telefono. Vedere Formato del numero di telefono - la maggior parte dei problemi di “contatto mancante” si riducono al formato E.164 o nazionale.La ricerca avviene dopo l’esecuzione dell’azione del flusso di lavoro
Se il flusso di lavoro HubSpot viene eseguito immediatamente dopo l’invio del modulo, le condizioni di gara possono far sì che il flusso di lavoro si attivi prima che Flowella abbia finito di scrivere il contatto. Aggiungete un breve ritardo (1-2 minuti) all’inizio del flusso di lavoro, oppure attivate la modifica della proprietà del contatto invece dell’invio del modulo.3. Azioni del flusso di lavoro bloccate o non riuscite
Se un flusso di lavoro HubSpot che include un’azione Flowella è bloccato:Aprire la cronologia delle azioni del flusso di lavoro.
In HubSpot, trovare il contatto, scorrere fino a Cronologia del flusso di lavoro e fare clic sull’esecuzione non riuscita. HubSpot mostra la risposta restituita da Flowella per ogni azione.Risposte agli errori più comuni
| Errore | Cosa fare |
|---|---|
Channel not found | Il flusso di lavoro punta a un canale che non esiste più. Modificare l’azione e scegliere un canale corrente. Vedere Multicanale. |
Template not approved | Il modello di riferimento ha cambiato stato in REJECTED, PAUSED o DISABLED. Vedere Template rejected. |
Contact opted out | Il contatto ha rinunciato a questo canale. Rispettare l’opt-out, non aggirarlo. |
Phone number invalid | Il telefono del contatto non è in formato E.164. Vedere Formato del numero di telefono. |
Subscription required | Il piano Flowella non include questa azione o l’abbonamento è scaduto. Vedere Fatturazione. |
L’azione esiste ma non fa nulla
Se il flusso di lavoro viene eseguito senza errori ma non arriva alcun messaggio, ricontrollare:- L’azione sia abilitata (non in pausa).
- Il destinatario è iscritto al flusso di lavoro nella fase giusta.
- I criteri di iscrizione di HubSpot corrispondono ancora al contatto.
4. Confusione della direzione di sincronizzazione
La sincronizzazione di Flowella è bidirezionale ma parziale:- Invii WhatsApp Flow → scrivono le proprietà dei contatti in HubSpot.
- Azioni del flusso di lavoro HubSpot → inviano messaggi e modelli WhatsApp.
- Risposte WhatsApp in entrata → registrate nella cronologia dei contatti (non aggiorna automaticamente le proprietà).
Ancora bloccato?
Acquisire quanto segue prima di contattare il supporto:
- Il timestamp dell’ultima sincronizzazione da Impostazioni → HubSpot
- L’esatto messaggio di errore (o schermata) restituito da Flowella o HubSpot
- L’ID del contatto e l’ID del flusso di lavoro interessati