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

# Adicionar o canal personalizado do Flowella à caixa de entrada do HubSpot

> Ligue o Flowella como canal personalizado do HubSpot para que as conversas WhatsApp cheguem à caixa de entrada de conversas junto do email, chat e chamadas da sua equipa.

O canal personalizado do Flowella traz todas as conversas WhatsApp que o Flowella gere para a [caixa de entrada de conversas](https://knowledge.hubspot.com/inbox/compose-and-reply-to-emails-in-the-conversations-inbox) do HubSpot. A sua equipa lê e responde aos tópicos WhatsApp a partir do mesmo local onde trata do email, chat e chamadas, e cada mensagem fica registada no registo do contacto.

No ecrã **Connect a channel** do HubSpot, o Flowella aparece como **Flowella Channel**, ao lado de Team email, Forms, Facebook Messenger, WhatsApp e Calling.

## O que o canal Flowella lhe dá

* Uma única caixa de entrada para conversas WhatsApp, juntamente com os seus outros canais HubSpot.
* Encaminhamento automático de novas conversas para os utilizadores ou equipas certos.
* Respostas e modelos registados no contacto, visíveis na cronologia e nos relatórios.
* A capacidade de alternar entre o WhatsApp e outros canais a meio de uma conversa a partir do editor de respostas.

## Requisitos

Os canais personalizados são controlados pelo HubSpot, não pelo Flowella. O seu portal precisa de uma das subscrições qualificadas antes de a opção **Flowella Channel** aparecer.

<Note>
  **Disponível com qualquer uma das seguintes subscrições HubSpot, salvo indicação em contrário:**

  * **Sales Hub** Professional ou Enterprise
  * **Service Hub** Professional ou Enterprise

  Podem também ser necessários HubSpot Credits. Consulte o guia do HubSpot, [Connect custom channels to the conversations inbox](https://knowledge.hubspot.com/inbox/connect-custom-channels-to-the-conversations-inbox), para os termos atuais.
</Note>

As permissões e lugares são divididos pelos passos:

| Para fazer isto | Precisa de |
| - | - |
| Instalar a aplicação Flowella no seu portal | Permissão de acesso ao App Marketplace |
| Ligar o canal à caixa de entrada de conversas | Super Admin |
| Definir regras de encaminhamento para o canal | Um lugar Sales ou Service |

## Antes de ligar

* A sua conta Flowella está ligada ao seu portal HubSpot. Consulte [Configuração](/pt/hubspot/setup) se ainda não o fez.
* A aplicação Flowella está instalada no seu portal HubSpot.
* Pelo menos uma Conta WhatsApp Business e um número de telefone estão ligados no Flowella.

## Ligar o canal Flowella

<Steps>
  <Step title="Abrir definições da caixa de entrada">
    No HubSpot, clique no ícone **definições** na barra de navegação superior. Na barra lateral esquerda, aceda a **Inbox & Help Desk** e clique em **Inbox**.
  </Step>

  <Step title="Iniciar a ligação de um canal">
    No canto superior direito, clique em **Connect a channel** e selecione **Flowella Channel** da lista de tipos de canal. Se não aparecer, confirme que a aplicação Flowella está instalada e reautorizada no seu portal.
  </Step>

  <Step title="Autorizar o canal">
    Clique em **Continue with Flowella Channel** e forneça as credenciais pedidas na janela pop-up. Os campos apresentados dependem da configuração do seu canal Flowella.
  </Step>

  <Step title="Definir regras de encaminhamento (opcional)">
    Escolha como as novas conversas WhatsApp são atribuídas. Pode encaminhar para utilizadores e equipas específicos, ou para o proprietário do contacto. A definição de regras de encaminhamento requer um lugar Sales ou Service.
  </Step>

  <Step title="Concluir">
    Clique em **Next** e depois em **Done**. O canal Flowella está ligado e as conversas WhatsApp recebidas aparecem agora na sua caixa de entrada de conversas.
  </Step>
</Steps>

## Como as mensagens fluem entre o WhatsApp e a caixa de entrada do HubSpot

O canal é **bidirecional** — cada mensagem WhatsApp recebida é publicada no HubSpot, e cada resposta enviada do HubSpot é retransmitida para o WhatsApp através do Meta, com o estado da ida e volta refletido em ambos os lados.

| Direção | O que acontece |
| - | - |
| **Recebida (WhatsApp → HubSpot)** | Quando um contacto envia uma mensagem WhatsApp, o Flowella cria ou faz a correspondência com o contacto HubSpot e publica a mensagem no tópico do canal Flowella. A mesma mensagem permanece visível na [caixa de entrada do Flowella](/pt/app/inbox). |
| **Enviada (HubSpot → WhatsApp)** | Quando um agente responde a partir da caixa de entrada do HubSpot, o Flowella encaminha a mensagem para o Meta e escreve o resultado da entrega (`SENT` ou `FAILED`) de volta no tópico HubSpot para que o agente veja o mesmo estado que veria na caixa de entrada do Flowella. Se o envio falhar, o motivo do erro do WhatsApp aparece nos detalhes **Not delivered** da mensagem. |
| **Modelos a partir do HubSpot** | O compositor de respostas permite-lhe enviar modelos aprovados e os modelos de reabertura do Flowella (consulte [Modelos de resposta](/pt/settings/reply-templates)) quando a janela de 24 horas se fechou. |

<Note>
  A ligação é tratada através do endpoint alojado do Flowella em `https://api.flowella.io/api/webhooks/hubspot/channel/connect`. Este URL é definido pelo ambiente e resolvido automaticamente durante o assistente de ligação do marketplace — não há nada para copiar ou colar. Se anteriormente viu um erro **Invalid settings** ou 500 ao tentar ligar o canal, esse problema já está corrigido.
</Note>

## Responder a partir da caixa de entrada

Uma vez ligado, as conversas WhatsApp comportam-se como qualquer outro canal na caixa de entrada. Abra a caixa de entrada, filtre pelo canal Flowella se quiser focar-se no WhatsApp e responda em tempo real.

<Note>
  As respostas em texto livre só são possíveis dentro da janela de apoio ao cliente de 24 horas do WhatsApp. Depois de 24 horas desde a última mensagem do contacto, só pode enviar um modelo aprovado. Esta é uma regra da WhatsApp Business Platform, não um limite do HubSpot ou do Flowella. Consulte [Utilizar a caixa de entrada](/pt/app/inbox) e [Modelos](/pt/app/templates).
</Note>

### Quando a janela de 24 horas está fechada

Se enviar uma resposta em texto livre depois da janela ter fechado, o Flowella não a entrega. A mensagem é marcada como não entregue no tópico HubSpot com o motivo:

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

O Flowella publica então uma mensagem de orientação no tópico ("The WhatsApp 24-hour window has closed. Use Re-engage to send an approved template.") juntamente com chips de resposta rápida **Re-engage**.

### Chips de reengajamento

Os chips permitem-lhe reabrir a conversa sem sair da caixa de entrada do HubSpot. Cada chip envia um dos [modelos de reabertura](/pt/settings/reply-templates) do sistema do Flowella com a mensagem de reengajamento predefinida:

| Chip | Modelo de reabertura | Quando aparece |
| - | - | - |
| **Re-engage** | Service | Sempre |
| **Send update** | Update | Quando o modelo de reabertura Update está ativado e aprovado |
| **Send offer** | Offer | Quando o modelo de reabertura Offer está ativado e aprovado |

Clique num chip e o Flowella envia o modelo aprovado correspondente para o contacto. O envio é registado no tópico como uma mensagem de modelo e é cobrado como uma mensagem Utilitário segundo o preço por mensagem do Meta. Se o modelo ainda não estiver aprovado pelo Meta, o envio é marcado como não entregue com o motivo `Re-engagement template is not available`.

### Motivos de falha na entrega

Quando o Meta rejeita uma mensagem enviada por qualquer outro motivo, o Flowella marca a mensagem como `FAILED` e escreve o erro do WhatsApp no tópico HubSpot. Clique no estado **Not delivered** da mensagem para ver o motivo, no formato:

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

O motivo inclui o código de erro do Meta para que possa consultá-lo na [referência de códigos de erro](https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/) do Meta. O mesmo motivo é registado na mensagem no Flowella.

## Gerir ou remover o canal

Aceda a **Settings > Inbox & Help Desk > Inbox**, depois passe o rato sobre o canal Flowella:

* **Edit** para alterar o encaminhamento e atribuição.
* **Options > Move to help desk** para mover o canal e as suas conversas para o help desk.
* **Options > Delete** para remover o canal.
* Alterne o interruptor **Status** para desativar o canal sem o eliminar.

## Relacionado

<CardGroup cols={2}>
  <Card title="Configuração" icon="plug" href="/pt/hubspot/setup">
    Ligue a sua conta Flowella ao seu portal HubSpot.
  </Card>

  <Card title="Utilizar a caixa de entrada" icon="inbox" href="/pt/app/inbox">
    Leia, responda e faça a gestão das conversas WhatsApp no Flowella.
  </Card>

  <Card title="Atividade do contacto" icon="activity" href="/pt/hubspot/contact-activity">
    Veja toda a atividade WhatsApp registada num contacto.
  </Card>

  <Card title="Ações de fluxo de trabalho" icon="git-branch" href="/pt/hubspot/workflow-actions">
    Acione envios WhatsApp a partir de fluxos de trabalho HubSpot.
  </Card>
</CardGroup>


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