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

# Come si integrano i pezzi di Flowella

> Una vista di alto livello di come dati, messaggi e webhook si muovono tra HubSpot, Flowella e WhatsApp Business Platform di Meta lungo l'intera integrazione.

Flowella si colloca tra CRM e Meta di WhatsApp Business Platform. Questa pagina spiega, ad alto livello, dove risiede ciascun pezzo e come si muovono i dati tra di essi.

## I tre sistemi

<CardGroup cols={3}>
  <Card title="HubSpot" icon="database">
    La vostra fonte di verità per contatti, moduli, proprietà e flussi di lavoro.
  </Card>

  <Card title="Flowella" icon="workflow">
    Fa da ponte tra HubSpot e WhatsApp. Possiede i flussi, i modelli, la casella di posta, gli opt-out e l'API.
  </Card>

  <Card title="Meta (WhatsApp)" icon="message-circle">
    Ospita le WABA, i numeri di telefono, i modelli e la WhatsApp Business Platform stessa.
  </Card>
</CardGroup>

## Flusso di dati in sintesi

Una tipica interazione end-to-end si presenta come segue:

<Steps>
  <Step title="Innesco">
    Un flusso di lavoro HubSpot, un annuncio click-to-WhatsApp o un contatto che invia un messaggio al vostro numero danno il via alle operazioni.
  </Step>

  <Step title="Flowella decide cosa inviare">
    Flowella controlla lo stato di opt-in, seleziona il modello o il flusso giusto e risolve eventuali variabili dalle proprietà HubSpot.
  </Step>

  <Step title="Meta trasmette il messaggio">
    Flowella invia il messaggio tramite Meta di WhatsApp Business Platform. Il contatto lo riceve su WhatsApp.
  </Step>

  <Step title="Il contatto risponde o completa un flusso">
    Le risposte e gli invii del flusso ritornano attraverso i webhook di Meta a Flowella.
  </Step>

  <Step title="Flowella scrive il risultato a HubSpot">
    Gli invii di moduli, le risposte al flusso e le attività di conversazione si sincronizzano con il contatto HubSpot corrispondente, attivando i flussi di lavoro HubSpot impostati.
  </Step>
</Steps>

## Cosa vive dove

\| Preoccupazione, sistema...
\| --- | --- |
\| Contatti, moduli, proprietà, elenchi, flussi di lavoro | HubSpot |
\| WABA, numeri di telefono, modelli, nome visualizzato, consegna dei messaggi | Meta |
\| Flusso ↔ mappatura dei moduli, casella di posta, opt-out, chiavi API, webhook, fatturazione | Flowella |

## Confini dell'autenticazione

* **HubSpot** è connesso tramite OAuth. L'utente autorizza Flowella una volta durante l'onboarding; la connessione viene memorizzata a livello di organizzazione.
* **Meta** si connette tramite l'Embedded Signup di Meta. Flowella memorizza i token di accesso a lunga durata necessari per il funzionamento di WABA.
* L'API\*\* di Flowella è autenticata con le chiavi API create in **Impostazioni → Chiavi API**.
* I webhook in uscita\*\* da Flowella sono firmati in modo da poter verificare che le richieste provengano da noi. Configurateli in **Impostazioni → Webhook**.

## Multi-canale e multi-WABA

Una singola org Flowella può ospitare più WABA e più numeri di telefono. La maggior parte delle pagine dell'app è limitata a un canale: quando si sceglie un canale, l'URL cambia in `/{org}/{waba}/{phone}/…`. Per sapere come passare da un canale all'altro, vedere [Multicanale e multiWABA](/it/essentials/multi-channel).

<Tip>
  Se state valutando Flowella per un acquirente tecnico, abbinate questa pagina a [Sicurezza dei dati](/it/security/data-security).
</Tip>

## Correlato

<CardGroup cols={2}>
  <Card title="Multicanale" icon="layers" href="/it/essentials/multi-channel">
    Come i canali, le WABA e i numeri di telefono si adattano agli URL Flowella.
  </Card>

  <Card title="Glossario" icon="book" href="/it/essentials/glossary">
    Definizioni di WABA, canale, conversazione, modello e altro.
  </Card>

  <Card title="Introduzione all'API" icon="code" href="/it/api-reference/introduction">
    Autorizzazione, errori, limiti di velocità e paginazione.
  </Card>

  <Card title="Stato e incidenti" icon="activity" href="/it/essentials/status-and-incidents">
    Triage quando qualcosa non va su Flowella, Meta o HubSpot.
  </Card>
</CardGroup>