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

# Eventos de notificação

> O catálogo completo de notificações na aplicação e por email que o Flowella envia, agrupado por categoria, com canais de entrega e se podem ser desativadas.

O Flowella envia notificações quando algo importante acontece no seu espaço de trabalho — um modelo é aprovado, está a aproximar-se de um limite de utilização, uma sincronização HubSpot falha ou um colega aceita um convite. Esta página cataloga todos os eventos que o Flowella pode emitir, onde aparecem e como gerir as suas preferências.

Para o feed de notificações na aplicação, consulte [Notificações](/pt/app/notifications). Para a interface de preferências de notificação, consulte [Definições → Preferências de notificação](/pt/settings/notification-preferences).

## Como as notificações são entregues

As notificações podem chegar em até três locais:

| Canal | Onde aparece | Personalizável |
| - | - | - |
| **Feed na aplicação** | Ícone de sino, canto superior direito — `/notifications` | Por categoria (maioria dos eventos) |
| **Email** | O endereço de email no seu perfil de utilizador Flowella | Por categoria (maioria dos eventos) |
| **Email operacional** | O email de faturação da organização | Sempre ativo para faturação/segurança |

Cada evento abaixo mostra que canais o entregam por defeito.

## Catálogo de eventos

### Conta e autenticação

| Chave do evento | Descrição | Canais | Opcional? |
| - | - | - | - |
| `WELCOME` | Enviado imediatamente após registar uma conta Flowella. Confirma o registo e liga à integração. | Aplicação + email | Não |
| `AUTH_PASSWORD_CHANGED` | A sua palavra-passe foi alterada. | Aplicação + email | **Não — obrigatório** |
| `AUTH_MAGIC_LINK_REQUESTED` | Foi pedido um início de sessão por magic link para a sua conta. | Apenas email | **Não — obrigatório** |
| `AUTH_NEW_DEVICE` | Um novo dispositivo ou localização iniciou sessão. | Aplicação + email | **Não — obrigatório** |
| `ORG_INVITE_ACCEPTED` | Alguém que convidou aceitou e juntou-se à organização. | Aplicação | Sim |

<Note>
  Não é possível desativar eventos de autenticação e segurança. Isto é aplicado no servidor independentemente das suas preferências de notificação.
</Note>

### Faturação e utilização

| Chave do evento | Descrição | Canais | Opcional? |
| - | - | - | - |
| `BILLING_SUBSCRIPTION_STARTED` | Foi ativada uma nova subscrição para a organização. | Aplicação + email operacional | Operacional sempre ativo |
| `BILLING_SUBSCRIPTION_CHANGED` | O plano foi atualizado ou reduzido. | Aplicação + email operacional | Operacional sempre ativo |
| `BILLING_PAYMENT_FAILED` | O Stripe não conseguiu cobrar o cartão em ficheiro. | Aplicação + email operacional | Operacional sempre ativo |
| `BILLING_PAYMENT_RECOVERED` | Um pagamento falhado foi bem-sucedido na retentativa. | Aplicação + email operacional | Operacional sempre ativo |
| `BILLING_SUBSCRIPTION_CANCELLED` | A subscrição foi cancelada e terminará no fecho do período. | Aplicação + email operacional | Operacional sempre ativo |
| `BILLING_TRIAL_STARTED` | O teste gratuito de 14 dias foi provisionado no registo. | Aplicação + email | Sim |
| `BILLING_TRIAL_ENDING` | O teste de 14 dias termina em menos de 72 horas. | Aplicação + email | Sim |
| `BILLING_TRIAL_EXPIRED` | A janela do teste fechou. | Aplicação + email operacional | Operacional sempre ativo |
| `USAGE_SOFT_50` | Utilizou 50% da franquia mensal de mensagens faturáveis do seu plano (ou o limite de 5.000 mensagens do teste). | Aplicação + email | Sim |
| `USAGE_SOFT_80` | Utilizou 80% da franquia mensal do seu plano. | Aplicação + email | Sim |
| `USAGE_HARD_100` | Utilizou 100% da franquia mensal do seu plano — aplica-se excedente (ou, no teste, os envios estão agora bloqueados). | Aplicação + email operacional | Operacional sempre ativo |

### Modelos

| Chave do evento | Descrição | Canais | Opcional? |
| - | - | - | - |
| `TEMPLATE_SUBMITTED` | Um modelo foi submetido à Meta para aprovação. | Aplicação | Sim |
| `TEMPLATE_APPROVED` | A Meta aprovou um modelo. | Aplicação + email | Sim |
| `TEMPLATE_REJECTED` | A Meta rejeitou um modelo. A notificação inclui o motivo de rejeição da Meta. | Aplicação + email | Sim |
| `TEMPLATE_FLAGGED` | A Meta pausou um modelo devido a problemas de qualidade. | Aplicação + email | Sim |
| `TEMPLATE_PAUSED` | A Meta transitou um modelo para `PAUSED`. Envios de jornadas, campanhas e ações HubSpot que o usam ficam bloqueados até a Meta o restaurar. Aparece como o distintivo **Pausado pelo WhatsApp** na lista de modelos. | Aplicação + email | Sim |
| `TEMPLATE_DISABLED` | A Meta transitou um modelo para `DISABLED`. O modelo deve ser atualizado ou substituído antes de enviar novamente. Aparece como o distintivo **Desativado pelo WhatsApp** na lista de modelos. | Aplicação + email | Sim |
| `TEMPLATE_QUALITY` | A pontuação de qualidade da Meta para um modelo caiu para `RED`. Aparece como o distintivo **Qualidade: Vermelho** na lista de modelos. | Aplicação + email | Sim |
| `TEMPLATE_CATEGORY_CHANGED` | A Meta recategorizou um modelo (por exemplo, Marketing → Utility). | Aplicação + email | Sim |

### WhatsApp Flows e formulários

| Chave do evento | Descrição | Canais | Opcional? |
| - | - | - | - |
| `FLOW_SYNC_SUCCEEDED` | Um formulário HubSpot foi sincronizado com sucesso com um WhatsApp Flow. | Aplicação | Sim |
| `FLOW_SYNC_FAILED` | Uma execução de sincronização falhou. A notificação inclui a mensagem de erro segura para utilizadores. | Aplicação + email | Sim |
| `FLOW_PUBLISHED` | Um Flow foi publicado na Meta. | Aplicação | Sim |

### Integração HubSpot

| Chave do evento | Descrição | Canais | Opcional? |
| - | - | - | - |
| `HUBSPOT_CONNECTED` | OAuth HubSpot concluído. | Aplicação | Sim |
| `HUBSPOT_DISCONNECTED` | Ligação HubSpot foi perdida ou revogada. | Aplicação + email | Sim |
| `HUBSPOT_SYNC_FAILED` | Uma execução de sincronização HubSpot agendada falhou. | Aplicação + email | Sim |

### Canais e Meta

| Chave do evento | Descrição | Canais | Opcional? |
| - | - | - | - |
| `CHANNEL_CONNECTED` | Um novo canal WhatsApp foi adicionado. | Aplicação | Sim |
| `META_VERIFICATION_REQUIRED` | O canal precisa de verificação de negócio antes de poder enviar. | Aplicação + email | Sim |
| `META_VERIFICATION_COMPLETED` | Verificação de negócio concluída. | Aplicação | Sim |
| `QUALITY_RATING_DROP` | A classificação de qualidade do canal caiu para **Média** ou **Baixa**. | Aplicação + email | Sim |

### Exportações e trabalhos de longa duração

| Chave do evento | Descrição | Canais | Opcional? |
| - | - | - | - |
| `EXPORT_READY` | Uma exportação CSV/PDF que acionou está pronta para descarregar. | Aplicação | Sim |
| `IMPORT_COMPLETED` | Uma importação CSV (por exemplo, opt-outs) terminou. | Aplicação | Sim |

## Varreduras operacionais

O Flowella executa uma **varredura diária de lembretes de notificação**. Se uma notificação não lida `TEMPLATE_REJECTED`, `HUBSPOT_SYNC_FAILED` ou `BILLING_PAYMENT_FAILED` tem estado à espera por mais de 24 horas, a varredura torna-a a apresentar com um lembrete por email. Isto significa que não pode falhar silenciosamente um evento crítico ao fechar o ícone de sino.

## Onde gerir as suas preferências

* **Por utilizador, por categoria** — Definições → Preferências de notificação. Cada categoria acima pode ser ativada para na aplicação, email ou ambos, com exceção das categorias obrigatórias (autenticação, faturação operacional).
* **Email operacional por organização** — Definições → Organização → Email de notificações. Este é o destinatário para emails operacionais globais da organização, de faturação, segurança e outros.

<Tip>
  Se não está a receber emails que espera, primeiro verifique em Definições → Perfil que o seu endereço de email está verificado, depois procure na pasta de spam por mensagens de `notifications@flowella.io`. Emails não verificados não recebem notificações.
</Tip>

## Relacionado

<CardGroup cols={2}>
  <Card title="Preferências de notificação" icon="bell" href="/pt/settings/notification-preferences">
    Escolha que categorias entregam na aplicação, por email ou ambos.
  </Card>

  <Card title="Feed de notificações" icon="inbox" href="/pt/app/notifications">
    Leia e limpe notificações na aplicação.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/pt/settings/webhooks">
    Envie os mesmos eventos para os seus próprios sistemas.
  </Card>

  <Card title="Estado e incidentes" icon="activity" href="/pt/essentials/status-and-incidents">
    Eventos operacionais e onde fazer triagem quando algo falha.
  </Card>
</CardGroup>


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