Vai al contenuto principale
La maggior parte dei problemi tra Flowella e HubSpot rientra in tre gruppi: la connessione, l’arrivo delle risposte dei Flow in HubSpot e le azioni dei workflow che falliscono. Andate alla sezione che corrisponde a ciò che vedete. Per la configurazione, consultate Collegare HubSpot. Per sapere cosa fa ciascuna azione, consultate Azioni dei workflow HubSpot.

​
Controllare la connessione

1

Aprite le impostazioni HubSpot

In Flowella, andate su Settings → HubSpot. La scheda Connection mostra Connected o Not connected, con il vostro Portal (Hub) ID. Lo stato HubSpot nella barra superiore dell’app mostra lo stesso stato.
2

Ricollegate se indica Not connected

Un owner o un admin seleziona Connect HubSpot e approva le autorizzazioni in HubSpot. Flowella mostra Not connected anche quando HubSpot smette di accettare l’accesso di Flowella, ad esempio dopo che qualcuno ha disinstallato l’app in HubSpot. Finché HubSpot non è connesso, Flowella invia un promemoria HubSpot connection: “Reconnect or review HubSpot so CRM sync keeps working.”
3

Controllate le funzionalità se qualcosa non funziona

Se la scheda indica Connected ma una funzione non funziona, guardate la scheda Capabilities. Le funzioni sotto Not available richiedono autorizzazioni che HubSpot non ha concesso. Per ottenere nuove autorizzazioni, disconnettete e ricollegate: non esiste un pulsante di riconnessione separato. Consultate Ricollegare per sbloccare nuove funzionalità.
Mentre HubSpot è disconnesso, le azioni dei workflow non possono inviare, nessuna attività arriva a HubSpot e il canale Flowella nella inbox di HubSpot smette di funzionare. Se usate il canale personalizzato, ricollegatelo dopo aver ricollegato HubSpot.
Per gli errori mostrati durante la connessione, consultate la risoluzione dei problemi di Collegare HubSpot.

​
Risposte dei Flow mancanti in HubSpot

Quando un contatto invia un WhatsApp Flow, Flowella invia le risposte al modulo HubSpot da cui è stato creato il Flow. Per prima cosa, verificate se l’invio è arrivato. Consultate Verificare che un invio sia arrivato.
Il Flow resta aperto e mostra l’errore, così il contatto può riprovare.
  • “Missing required field:” seguito dall’etichetta di un campo indica che il modulo HubSpot ha un campo obbligatorio che il Flow non raccoglie, ad esempio uno aggiunto dopo l’ultima sincronizzazione. Selezionate Sync WA Flow nella pagina Flows, oppure rendete il campo facoltativo in HubSpot.
  • “Could not submit to HubSpot. Try again.” indica che HubSpot non ha accettato l’invio. Controllate la connessione, come descritto sopra.
Consultate Errori visualizzati dal cliente.
HubSpot associa l’invio di un modulo a un contatto tramite l’indirizzo email. Quando Flowella associa l’invio a un contatto HubSpot, aggiunge l’email di quel contatto. Se né il Flow né il contatto associato hanno un indirizzo email, HubSpot elenca l’invio senza contatto.Aggiungete un campo email al modulo HubSpot, poi selezionate Sync WA Flow. Oppure assicuratevi che i vostri contatti abbiano un indirizzo email in HubSpot.
Flowella associa l’invio al primo contatto che trova, in questo ordine:
  1. Il contatto iscritto dal workflow
  2. Il contatto già collegato al numero WhatsApp
  3. Un contatto con lo stesso numero di telefono
  4. Un contatto con lo stesso indirizzo email
Se nessuno corrisponde, Flowella crea un contatto.Salvate i numeri di telefono in formato internazionale senza spazi, come +447700900123, così Flowella può trovare i contatti tramite il telefono. Consultate Formato del numero di telefono.
Flowella non ha una mappatura dei campi da modificare. Crea il Flow a partire dai campi del modulo HubSpot e HubSpot salva ogni risposta nella proprietà usata dal campo del modulo. Anche l’obbligatorietà di un campo dipende da HubSpot.Per cambiare ciò che il Flow raccoglie, modificate il modulo in HubSpot, poi selezionate Sync WA Flow. I campi che WhatsApp non può mostrare vengono esclusi dal Flow. Consultate Come vengono convertiti i campi HubSpot.
Attendete l’evento Form Completed e filtratelo per Form name. Form Completed si attiva solo quando qualcuno invia un WhatsApp Flow, mai per l’invio di un modulo del sito web. Consultate Form Completed.

​
Azioni dei workflow che falliscono

​
Leggere l’errore in HubSpot

Aprite il workflow in HubSpot e cercate il contatto nella cronologia delle iscrizioni. Un passaggio Send WhatsApp Template, Send WhatsApp Message o Send WhatsApp Reply non riuscito mostra il messaggio di errore di Flowella. L’output Error code dell’azione contiene un codice breve e il workflow prosegue con il passaggio successivo. Consultate Output delle azioni di invio. Un passaggio di invio termina quando WhatsApp riporta per la prima volta uno stato per il messaggio, di solito sent. Se WhatsApp segnala un errore dopo quel momento, il passaggio risulta comunque riuscito. Per vedere cosa è successo dopo, aprite la conversazione nell’Inbox di Flowella.

​
Codici di errore delle azioni di invio

Tutti i codici, con il loro significato, sono elencati in Codici di errore. Usate questa tabella per decidere dove guardare per prima cosa.

​
Invio del template soppresso come duplicato

Se un passaggio Send WhatsApp Template fallisce con DUPLICATE_TEMPLATE_SEND_SUPPRESSED, Flowella ha saltato l’invio intenzionalmente. Lo stesso template, nella stessa lingua, è stato inviato allo stesso numero di telefono dallo stesso numero WhatsApp meno di 15 secondi prima. Quel numero di telefono ha comunque ricevuto il template una volta. La causa abituale sono due contatti HubSpot che condividono un numero di telefono, come un record personale e uno di lavoro, iscritti allo stesso workflow nello stesso momento. Il passaggio fallisce subito, quindi il contatto passa al passaggio successivo senza attendere. Nel Send log del template, la ripetizione compare come Suppressed, con “Duplicate send suppressed within 15 seconds.” Per distinguerlo da un errore reale:
  • Soppresso come duplicato: il codice è esattamente DUPLICATE_TEMPLATE_SEND_SUPPRESSED. Non serve alcuna azione.
  • Un errore reale: qualsiasi altro codice. Consultate Codici di errore delle azioni di invio.
Per inviare intenzionalmente lo stesso template allo stesso numero due volte, lasciate più di 15 secondi tra gli invii oppure usate un template diverso.

​
Il passaggio resta in attesa

Se un passaggio Send WhatsApp Template resta in corso, WhatsApp potrebbe aver sospeso o disattivato il template. Flowella trattiene l’invio e lo effettua quando WhatsApp ripristina il template. Controllate il badge del template nella pagina Templates. Consultate Badge sullo stato di consegna.

​
Il passaggio è riuscito ma non è arrivato nulla

Cercate il messaggio nell’Inbox di Flowella. Send WhatsApp Message e Send WhatsApp Reply inviano sempre dal vostro numero WhatsApp predefinito. Se il messaggio mostra Failed, leggete il motivo sotto e consultate Messaggi non consegnati.

​
Cosa scrive Flowella in HubSpot

Flowella aggiunge a HubSpot questi elementi, a seconda delle funzionalità della vostra connessione:
  • Risposte dei Flow, come invio del modulo HubSpot da cui è stato creato il Flow.
  • Attività nella timeline del contatto: messaggio inviato, messaggio letto, risposta ricevuta e modulo completato.
  • Le proprietà di contatto Last WhatsApp reply message e Last WhatsApp reply at.
  • Nuovi contatti per le persone che vi scrivono e non sono ancora in HubSpot.
  • Conversazioni nella inbox di HubSpot, tramite il canale personalizzato Flowella.
Flowella non scrive opt-out o stati dei messaggi nelle proprietà di contatto. Per agire in base a ciò che un contatto ha risposto, create un ramo su Last WhatsApp reply message. Consultate Attività dei contatti e Cosa aggiunge Flowella a HubSpot.

​
Ancora bloccati?

Contattate il supporto Flowella indicando:
  • Il messaggio di errore e l’Error code dalla cronologia delle iscrizioni del workflow
  • L’ID del record del contatto HubSpot e il nome del workflow
  • La data e l’ora del passaggio non riuscito
  • Il vostro Portal (Hub) ID da Settings → HubSpot

​
Pagine correlate

Collegare HubSpot

Connessione, funzionalità e riconnessione.

Azioni dei workflow HubSpot

Cosa fa ciascuna azione, i suoi output e tutti i codici di errore.

Codici di errore WhatsApp

Cosa significano i codici di WhatsApp e come risolverli.

Flows

Sincronizzate i moduli HubSpot con WhatsApp Flows e verificate gli invii.
Ultima modifica il 24 ottobre 2026