> ## Documentation Index
> Fetch the complete documentation index at: https://docs.promete.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Business API

> Integração com a API oficial do WhatsApp Business

## WhatsApp Business API

A integração com a **API oficial do WhatsApp Business** é obrigatória desde o MVP e constitui o canal principal de comunicação entre o mandato e a base eleitoral.

## Funcionalidades Habilitadas

| Funcionalidade               | Descrição                                                                        |
| ---------------------------- | -------------------------------------------------------------------------------- |
| **Envio de mensagens**       | Disparo de mensagens individuais e em massa via templates aprovados              |
| **Recebimento de mensagens** | Captura de mensagens recebidas dos cidadãos                                      |
| **Registro automático**      | Toda interação via WhatsApp é automaticamente registrada no histórico do contato |
| **Triagem por IA**           | Mensagens recebidas são triadas e classificadas automaticamente                  |
| **Encaminhamento**           | Demandas recebidas via WhatsApp são encaminhadas ao responsável adequado         |
| **Notificações**             | Envio de notificações automáticas sobre atualizações de demandas e ações         |

## Requisitos Técnicos

A integração requer conta verificada no WhatsApp Business, acesso à API oficial da Meta (Cloud API ou On-Premise), templates de mensagem aprovados pela Meta, número de telefone dedicado e configuração de webhooks para recebimento de mensagens.

## Limitações e Riscos

| Risco                         | Impacto                                            | Mitigação                                          |
| ----------------------------- | -------------------------------------------------- | -------------------------------------------------- |
| Mudança nas políticas da Meta | Pode restringir funcionalidades ou aumentar custos | Monitorar atualizações, manter canais alternativos |
| Limites de envio              | Restrição no volume de mensagens por período       | Respeitar limites, escalar gradualmente            |
| Bloqueio de conta             | Uso inadequado pode resultar em banimento          | Seguir rigorosamente as políticas de uso           |
| Custo por mensagem            | Modelo de cobrança por conversa                    | Otimizar disparos, priorizar templates             |

<Warning>
  A dependência do WhatsApp Business API é um ponto crítico do sistema. Recomenda-se documentar e prever canais de fallback para mitigar riscos de indisponibilidade.
</Warning>