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

# Como o Flowella se encaixa

> Uma vista de alto nível de como os dados, as mensagens e os webhooks se movem entre o HubSpot, o Flowella e a WhatsApp Business Platform do Meta, ao longo de toda a integração.

O Flowella situa-se entre o CRM e o Meta do WhatsApp Business Platform. Esta página explica, a um nível elevado, onde cada peça reside e como os dados se movem entre elas.

## Os três sistemas

<CardGroup cols={3}>
  <Card title="HubSpot" icon="database">
    A sua fonte de verdade para contactos, formulários, propriedades e fluxos de trabalho.
  </Card>

  <Card title="Fluxela" icon="workflow">
    Faz a ponte entre o HubSpot e o WhatsApp. Possui fluxos, modelos, a caixa de entrada, opt-outs e a API.
  </Card>

  <Card title="Meta (WhatsApp)" icon="message-circle">
    Aloja o seu WABA, números de telefone, modelos e o próprio WhatsApp Business Platform.
  </Card>
</CardGroup>

## Fluxo de dados num relance

Uma interação típica de ponta a ponta tem o seguinte aspeto:

<Steps>
  <Step title="Gatilho">
    Um fluxo de trabalho HubSpot, um anúncio click-to-WhatsApp ou um contacto que envia uma mensagem para o seu número dão início ao processo.
  </Step>

  <Step title="Flowella decide o que enviar">
    O Flowella verifica o estado do opt-in, seleciona o modelo ou Fluxo correto e resolve quaisquer variáveis das propriedades do HubSpot.
  </Step>

  <Step title="Meta transmite a mensagem">
    O Flowella envia a mensagem através do Meta do WhatsApp Business Platform. O contacto recebe-a no WhatsApp.
  </Step>

  <Step title="O contacto responde ou completa um fluxo">
    As respostas e os envios de Flow voltam através dos webhooks do Meta para o Flowella.
  </Step>

  <Step title="Flowella escreve o resultado de volta para o HubSpot">
    Os envios de formulários, as respostas do Flow e a atividade de conversação são sincronizados com o contacto HubSpot correspondente, accionando quaisquer fluxos de trabalho HubSpot que tenha configurado.
  </Step>
</Steps>

## O que vive onde

| Preocupação                                                                                    | Sistema  |
| ---------------------------------------------------------------------------------------------- | -------- |
| Registos de contactos, formulários, propriedades, listas, fluxos de trabalho                   | HubSpot  |
| WABA, números de telefone, modelos, nome de apresentação, entrega de mensagens                 | Meta     |
| Fluxo ↔ mapeamento de formulários, caixa de entrada, opt-outs, chaves API, webhooks, faturação | Flowella |

## Limites de autenticação

* **HubSpot** está ligado através de OAuth. Autoriza o Flowella uma vez durante o onboarding; a ligação é armazenada ao nível da organização.
* O **Meta** está ligado através do Registo incorporado do Meta. O Flowella armazena os tokens de acesso de longa duração necessários para operar o WABA.
* **A API** do Flowella é autenticada com chaves de API criadas em **Configurações → Chaves de API**.
* **Os webhooks de saída** da Flowella são assinados para que possa verificar se os pedidos vieram de nós. Configure-os em **Configurações → Webhooks**.

## Multi-canal e multi-WABA

Uma única organização Flowella pode alojar várias WABAs e vários números de telefone. A maior parte das páginas de aplicações têm como âmbito um canal - verá o URL mudar para `/{org}/{waba}/{phone}/…` quando escolher um canal. Veja [Multi-canal e multi-WABA](/pt/essentials/multi-channel) para saber como alternar entre eles.

<Tip>
  Se estiver a avaliar o Flowella para um comprador técnico, emparelhe esta página com [Segurança de dados](/pt/security/data-security).
</Tip>

## Relacionado

<CardGroup cols={2}>
  <Card title="Multicanal" icon="layers" href="/pt/essentials/multi-channel">
    Como os canais, WABAs e números de telefone são mapeados nos URLs do Flowella.
  </Card>

  <Card title="Glossário" icon="book" href="/pt/essentials/glossary">
    Definições para WABA, canal, conversação, modelo e mais.
  </Card>

  <Card title="Introdução à API" icon="code" href="/pt/api-reference/introduction">
    Autenticação, erros, limites de taxa e paginação.
  </Card>

  <Card title="Situação e incidentes" icon="activity" href="/pt/essentials/status-and-incidents">
    Triagem quando algo está errado no Flowella, Meta ou HubSpot.
  </Card>
</CardGroup>