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

# Ações bloqueadas pela faturação

> O que fazer quando o envio de mensagens WhatsApp, a publicação de modelos ou o uso da API Flowella são bloqueados por um estado da subscrição, e como recuperar.

Algumas acções no Flowella requerem uma subscrição ativa. Se vir "Subscrição necessária", um erro `402` da API, ou botões que estão a cinzento com uma dica de ferramenta de faturação, esta página explica o que está bloqueado e como desbloqueá-lo.

Para obter o modelo de subscrição completo, consulte [Faturação](/pt/account/billing).

## O que é bloqueado

Quando uma subscrição se torna **vencida** ou **cancelada** (e o período pago terminou), os seguintes itens são bloqueados:

* Envio de novas mensagens WhatsApp a partir da caixa de entrada
* Envio de modelos a partir de fluxos de trabalho HubSpot
* Envio de modelos em massa através da API (`POST /v1/templates/send`)
* Publicação ou sincronização de novos WhatsApp Flows
* Envio de novos modelos para o Meta
* Adicionar novos canais ou números de telefone

Estes permanecem disponíveis para que possa recuperar:

* Iniciar sessão
* Visualizar dados existentes - contactos, conversas, opt-outs, análises, modelos
* A página de faturação
* Receção de mensagens recebidas (as mensagens WhatsApp recebidas continuam a chegar à sua caixa de entrada; só não pode responder até que a faturação seja corrigida)

## Estados de subscrição que bloqueiam acções

| Estado | O que está a acontecer | O que verá |
| - | - | - |
| **Vencido** | Um pagamento com cartão falhou e o Stripe está a tentar novamente | Banner amarelo em todas as páginas; algumas acções bloqueadas |
| Cancelada (em falta)\*\* | A subscrição foi cancelada, mas o período pago ainda não terminou | Banner amarelo; acesso total até ao fim do período |
| Cancelada (expirada)\*\* | O período pago terminou | Banner vermelho; acções pagas bloqueadas |
| Plano pago em período de teste gratuito | Acesso total; sem banner | |
| Plano pago em boas condições | Acesso total; sem faixa | |

## Como restaurar o acesso

Apenas o **Proprietário** da organização pode alterar a faturação.

<Steps>
  <Step title="Abrir Definições → Faturação">
    Inicie sessão e vá a **Configurações → Faturação**.
  </Step>

  <Step title="Abrir o portal do cliente Stripe">
    Clique em **Gerir subscrição**. O Stripe abre-se num novo separador.
  </Step>

  <Step title="Atualizar o pagamento ou escolher um plano">
    * Para **vencido**, actualize o cartão em falha.
    * Para **expirado**, escolha um plano e conclua o checkout.
  </Step>

  <Step title="Aguardar alguns segundos">
    Os webhooks do Stripe actualizam o Flowella em segundos. A página de faturação é automaticamente sondada; actualize outras páginas para limpar o banner.
  </Step>
</Steps>

## Comportamento API

A API REST devolve uma resposta `402 Payment Required` com este envelope quando uma ação é bloqueada por faturação:

```json theme={null}
{
  "error": {
    "code": "PAYMENT_REQUIRED",
    "message": "Your subscription does not allow this action."
  }
}
```

No seu cliente, trate o `402` como um estado recuperável - apresente-o ao proprietário da organização para que ele possa corrigir a faturação em vez de tentar novamente de forma automática.

## Confusão comum

### "Acabei de pagar - porque é que ainda está bloqueado?"

Os webhooks do Stripe são normalmente instantâneos, mas muito raramente demoram um ou dois minutos. Se o banner persistir por mais de cinco minutos após um pagamento bem-sucedido, atualize a página ou clique em **Gerenciar assinatura** para confirmar o status no Stripe.

### "Porque é que o meu colega de equipa ainda consegue enviar mensagens?"

Não podem - mas se a ação estiver em fila de espera do lado do cliente, a IU pode mostrar sucesso momentaneamente antes de o servidor a rejeitar. As tentativas de envio irão aparecer na caixa de entrada como **Failed** com um motivo de faturação.

### "Pagámos mas uma funcionalidade específica ainda está bloqueada"

Verifique se o seu **nível de plano** inclui essa funcionalidade. Consulte [Planos e limites](/pt/account/plans-and-limits). Por exemplo, o plano Starter não inclui a API REST pública — o acesso à API começa no Pro.

## Ainda bloqueado depois de pagar?

<Note>
  Capture o seguinte antes de contactar o [suporte](https://flowella.io/support):

  * Uma captura de ecrã de **Configurações → Faturação** mostrando o estado atual
  * O recibo Stripe ou o ID da fatura do pagamento mais recente

  Podemos reconciliar manualmente se um webhook não chegar.
</Note>

## Relacionado

<CardGroup cols={2}>
  <Card title="Faturação" icon="badge-dollar-sign" href="/pt/account/billing">
    Gerir a subscrição, o método de pagamento e a integridade do contador Stripe.
  </Card>

  <Card title="Planos e limites" icon="list" href="/pt/account/plans-and-limits">
    O que cada plano inclui e como os limites de avaliação diferem do excedente pago.
  </Card>

  <Card title="Utilização" icon="gauge" href="/pt/settings/usage">
    Veja em que ponto se encontra no ciclo de faturação atual.
  </Card>

  <Card title="Preços e categorias" icon="message-circle" href="/pt/account/pricing-and-conversation-categories">
    Como as cobranças do Meta e o uso do Flowella interagem.
  </Card>
</CardGroup>


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