> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Errori di sincronizzazione HubSpot

> Diagnosticare gli invii di moduli mancanti, le azioni del flusso di lavoro in stallo e gli aggiornamenti dei contatti che non raggiungono HubSpot.

La maggior parte dei problemi di HubSpot rientra in una delle tre categorie: l'**integrazione è scollegata**, una **mappatura di campo è errata** o un'azione del **flusso di lavoro è mal configurata**. Questa pagina li analizza in ordine sparso.

Per la configurazione iniziale, vedere [HubSpot setup](/it/hubspot/setup). Per le azioni del flusso di lavoro, vedere [Azioni del flusso di lavoro](/it/hubspot/workflow-actions).

## 1. Controllare la connessione

<Steps>
  <Step title="Aprire Impostazioni → HubSpot">
    Dall'app Flowella, andare su **Impostazioni → HubSpot**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Ricollegare se necessario">
    Fare clic su **Reconnect** ed eseguire nuovamente HubSpot OAuth. Quindi riprovare l'azione non riuscita.
  </Step>
</Steps>

<Info>
  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.
</Info>

## 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](/it/app/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](/it/hubspot/phone-number-format) - 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](/it/essentials/multi-channel). |
| `Template not approved` | Il modello di riferimento ha cambiato stato in `REJECTED`, `PAUSED` o `DISABLED`. Vedere [Template rejected](/it/troubleshooting/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](/it/hubspot/phone-number-format).                                        |
| `Subscription required` | Il piano Flowella non include questa azione o l'abbonamento è scaduto. Vedere [Fatturazione](/it/account/billing).                                                |

### 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à).

Se ci si aspetta che una risposta WhatsApp in forma libera aggiorni una proprietà, è necessario un passaggio in più: un flusso di lavoro HubSpot che osservi l'evento di conversazione e analizzi la risposta, oppure un'integrazione personalizzata tramite [API](/it/api-reference/introduction).

## Ancora bloccato?

<Note>
  Acquisire quanto segue prima di contattare il [supporto](https://flowella.io/support):

  * 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
</Note>