1. Controllare la connessione
1
Aprire Impostazioni → HubSpot
Dall’app Flowella, andare su Impostazioni → HubSpot.
2
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.
3
Ricollegare se necessario
Fare clic su Reconnect ed eseguire nuovamente HubSpot OAuth. Quindi riprovare l’azione non riuscita.
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
Template send suppressed as duplicate
Se HubSpot mostra un’azione Invia modello WhatsApp completata con motivo di erroreDUPLICATE_TEMPLATE_SEND_SUPPRESSED, Flowella ha intenzionalmente saltato l’invio perché lo stesso modello era già stato inviato allo stesso numero di telefono all’interno della sua finestra di deduplicazione.
Il caso più comune sono due contatti HubSpot che condividono un numero di telefono — ad esempio un record personale e uno di lavoro, o un nucleo familiare con un solo numero WhatsApp — che si iscrivono allo stesso workflow a distanza di pochi secondi l’uno dall’altro. Solo il primo invio va a WhatsApp; il secondo viene soppresso in modo che il contatto non riceva lo stesso messaggio due volte.
In precedenza la seconda azione del workflow sarebbe rimasta in Pending per circa un’ora fino al timeout di callback di HubSpot. Flowella ora completa il callback immediatamente come fallito, in modo che il contatto iscritto passi al passaggio successivo (o al ramo “azione fallita”) senza attendere.
Come distinguerlo da un vero fallimento:
- Soppresso come duplicato — il motivo dell’errore è esattamente
DUPLICATE_TEMPLATE_SEND_SUPPRESSED. Il modello è stato effettivamente inviato a quel numero di telefono, solo tramite un altro contatto iscritto. Non è richiesta alcuna azione. - Vero fallimento di invio — l’errore sarà un motivo specifico come
Template not approved,Phone number invalid,Contact opted out, oppure un codice di errore Meta Graph. Segua la riga della tabella qui sopra.
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