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

# Aggiungere il canale personalizzato Flowella alla casella di posta HubSpot

> Collegate Flowella come canale personalizzato HubSpot in modo che le conversazioni WhatsApp arrivino nella casella di posta delle conversazioni insieme a e-mail, chat e chiamate per il vostro team.

Il canale personalizzato Flowella porta ogni conversazione WhatsApp gestita da Flowella nella [casella di posta delle conversazioni](https://knowledge.hubspot.com/inbox/compose-and-reply-to-emails-in-the-conversations-inbox) di HubSpot. Il vostro team legge e risponde ai thread WhatsApp dallo stesso posto in cui gestisce e-mail, chat e chiamate, e ogni messaggio viene registrato nella scheda del contatto.

Nella schermata **Connetti un canale** di HubSpot, Flowella appare come **Flowella Channel**, accanto a E-mail del team, Moduli, Facebook Messenger, WhatsApp e Chiamate.

## Cosa vi offre il canale Flowella

* Una singola casella di posta per le conversazioni WhatsApp, insieme agli altri canali HubSpot.
* Routing automatico delle nuove conversazioni verso gli utenti o i team giusti.
* Risposte e template registrati sul contatto, visibili nella timeline e nei report.
* La possibilità di passare tra WhatsApp e altri canali a metà conversazione dall'editor delle risposte.

## Requisiti

I canali personalizzati sono limitati da HubSpot, non da Flowella. Il vostro portale ha bisogno di uno degli abbonamenti idonei prima che appaia l'opzione **Flowella Channel**.

<Note>
  **Disponibile con uno dei seguenti abbonamenti HubSpot, salvo diversa indicazione:**

  * **Sales Hub** Professional o Enterprise
  * **Service Hub** Professional o Enterprise

  Potrebbero essere necessari anche i Crediti HubSpot. Consultate la guida di HubSpot, [Connect custom channels to the conversations inbox](https://knowledge.hubspot.com/inbox/connect-custom-channels-to-the-conversations-inbox), per i termini attuali.
</Note>

I permessi e le postazioni sono suddivisi tra i passaggi:

| Per fare questo | Vi serve |
| - | - |
| Installare l'app Flowella nel vostro portale | Autorizzazione di accesso all'App Marketplace |
| Collegare il canale alla casella di posta delle conversazioni | Super Admin |
| Impostare le regole di routing per il canale | Una postazione Sales o Service |

## Prima di collegare

* Il vostro account Flowella è collegato al vostro portale HubSpot. Vedere [Setup](/it/hubspot/setup) se non lo avete ancora fatto.
* L'app Flowella è installata nel vostro portale HubSpot.
* Almeno un WhatsApp Business Account e un numero di telefono sono collegati in Flowella.

## Collegare il canale Flowella

<Steps>
  <Step title="Aprire le impostazioni della casella di posta">
    In HubSpot, fate clic sull'icona **impostazioni** nella barra di navigazione superiore. Nella barra laterale sinistra, andate su **Inbox & Help Desk**, quindi fate clic su **Inbox**.
  </Step>

  <Step title="Iniziare a collegare un canale">
    In alto a destra, fate clic su **Connetti un canale**, quindi selezionate **Flowella Channel** dall'elenco dei tipi di canale. Se non compare, confermate che l'app Flowella sia installata e riautorizzata sul vostro portale.
  </Step>

  <Step title="Autorizzare il canale">
    Fate clic su **Continua con Flowella Channel** e fornite le credenziali richieste nella finestra popup. I campi mostrati dipendono dalla configurazione del vostro canale Flowella.
  </Step>

  <Step title="Impostare regole di routing (opzionale)">
    Scegliete come vengono assegnate le nuove conversazioni WhatsApp. Potete instradarle verso utenti e team specifici, o verso il proprietario del contatto. L'impostazione delle regole di routing richiede una postazione Sales o Service.
  </Step>

  <Step title="Terminare">
    Fate clic su **Avanti**, quindi su **Fatto**. Il canale Flowella è collegato e le conversazioni WhatsApp in entrata appaiono ora nella vostra casella di posta delle conversazioni.
  </Step>
</Steps>

## Come i messaggi fluiscono tra WhatsApp e la casella di posta HubSpot

Il canale è **bidirezionale** — ogni messaggio WhatsApp in entrata viene pubblicato su HubSpot e ogni risposta HubSpot in uscita viene inoltrata a WhatsApp tramite Meta con lo stato di andata e ritorno riflesso su entrambi i lati.

| Direzione | Cosa succede |
| - | - |
| **In entrata (WhatsApp → HubSpot)** | Quando un contatto invia un messaggio WhatsApp, Flowella crea o abbina il contatto HubSpot e pubblica il messaggio nel thread del canale Flowella. Lo stesso messaggio rimane visibile nella [casella di posta Flowella](/it/app/inbox). |
| **In uscita (HubSpot → WhatsApp)** | Quando un agente risponde dalla casella di posta HubSpot, Flowella inoltra il messaggio a Meta e riscrive l'esito della consegna (`SENT` o `FAILED`) nel thread HubSpot in modo che l'agente veda lo stesso stato che vedrebbe nella casella di posta Flowella. Se l'invio fallisce, il motivo dell'errore WhatsApp appare nei dettagli **Non consegnato** del messaggio. |
| **Template da HubSpot** | Il compositore di risposte vi consente di inviare template approvati e i template di riapertura di Flowella (vedere [Template di risposta](/it/settings/reply-templates)) quando la finestra di 24 ore è chiusa. |

<Note>
  La connessione viene gestita tramite l'endpoint ospitato da Flowella all'indirizzo `https://api.flowella.io/api/webhooks/hubspot/channel/connect`. Questo URL è basato sull'ambiente e viene risolto automaticamente durante la procedura guidata di connessione del marketplace — non c'è nulla da copiare o incollare. Se in precedenza avete visto un errore **Impostazioni non valide** o 500 durante il tentativo di collegare il canale, quel problema è ora risolto.
</Note>

## Rispondere dalla casella di posta

Una volta collegate, le conversazioni WhatsApp si comportano come qualsiasi altro canale nella casella di posta. Aprite la casella di posta, filtrate per il canale Flowella se volete concentrarvi su WhatsApp e rispondete in tempo reale.

<Note>
  Le risposte in testo libero sono possibili solo all'interno della finestra di 24 ore di assistenza clienti di WhatsApp. Dopo 24 ore dall'ultimo messaggio del contatto, potete inviare solo un template approvato. Questa è una regola della WhatsApp Business Platform, non un limite di HubSpot o di Flowella. Vedere [Utilizzo della casella di posta](/it/app/inbox) e [Template](/it/app/templates).
</Note>

### Quando la finestra di 24 ore è chiusa

Se inviate una risposta in testo libero dopo la chiusura della finestra, Flowella non la consegna. Il messaggio è contrassegnato come non consegnato nel thread HubSpot con il motivo:

```text theme={null}
WhatsApp 24-hour window closed, a template is required to re-engage
```

Flowella pubblica quindi un messaggio di guida nel thread ("The WhatsApp 24-hour window has closed. Use Re-engage to send an approved template.") insieme ai chip di risposta rapida **Re-engage**.

### Chip di riattivazione

I chip vi permettono di riaprire la conversazione senza uscire dalla casella di posta HubSpot. Ogni chip invia uno dei [template di riapertura](/it/settings/reply-templates) di sistema di Flowella con il messaggio di riattivazione predefinito:

| Chip | Template di riapertura | Quando appare |
| - | - | - |
| **Re-engage** | Service | Sempre |
| **Send update** | Update | Quando il template di riapertura Update è abilitato e approvato |
| **Send offer** | Offer | Quando il template di riapertura Offer è abilitato e approvato |

Fate clic su un chip e Flowella invia il template approvato corrispondente al contatto. L'invio viene registrato nel thread come messaggio template e viene addebitato come messaggio Utility secondo la tariffazione per messaggio di Meta. Se il template non è ancora approvato da Meta, l'invio è contrassegnato come non consegnato con il motivo `Re-engagement template is not available`.

### Motivi di errore nella consegna

Quando Meta rifiuta un messaggio in uscita per qualsiasi altro motivo, Flowella contrassegna il messaggio come `FAILED` e scrive l'errore WhatsApp nel thread HubSpot. Fate clic sullo stato **Non consegnato** sul messaggio per vedere il motivo, nel formato:

```text theme={null}
WhatsApp send failed: <Meta error reason> (code <error code>)
```

Il motivo include il codice di errore Meta in modo da poterlo cercare nel [riferimento dei codici di errore](https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/) di Meta. Lo stesso motivo viene registrato sul messaggio in Flowella.

## Gestire o rimuovere il canale

Andate su **Impostazioni > Inbox & Help Desk > Inbox**, quindi posizionate il cursore sul canale Flowella:

* **Modifica** per cambiare routing e assegnazione.
* **Opzioni > Sposta in help desk** per spostare il canale e le sue conversazioni in help desk.
* **Opzioni > Elimina** per rimuovere il canale.
* Attivate l'interruttore **Stato** per disattivare il canale senza eliminarlo.

## Correlati

<CardGroup cols={2}>
  <Card title="Setup" icon="plug" href="/it/hubspot/setup">
    Collegate il vostro account Flowella al vostro portale HubSpot.
  </Card>

  <Card title="Utilizzo della casella di posta" icon="inbox" href="/it/app/inbox">
    Leggete, rispondete e gestite le conversazioni WhatsApp in Flowella.
  </Card>

  <Card title="Attività del contatto" icon="activity" href="/it/hubspot/contact-activity">
    Visualizzate ogni attività WhatsApp registrata su un contatto.
  </Card>

  <Card title="Azioni dei workflow" icon="git-branch" href="/it/hubspot/workflow-actions">
    Attivate invii WhatsApp dai workflow HubSpot.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.