# Notificações de pedido pelo WhatsApp

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/pedidos/notificacoes-de-pedido-pelo-whatsapp

Quando a loja tem o WhatsApp Business conectado, você pode optar por enviar ao comprador **também pelo WhatsApp** as mesmas atualizações automáticas de pedido que já aparecem no **chat Unefesta**.

Por padrão essa opção fica **desligada**: o comprador vê as notificações só no chat Unefesta, sem custo extra de modelos utilitários na Meta. Para conectar o WhatsApp e entender tarifas, veja [WhatsApp Business (Meta)](../integracao/whatsapp-business-meta.md).

---

## Como ligar

1. No menu, abra **Integrações das Lojas**.
2. Na seção **WhatsApp Business (Meta)**, confira se a loja está **Conectada**.
3. Marque a opção  
   **Quero enviar notificações de pedido e pagamento também pelo WhatsApp (modelos UTILITY aprovados pela Meta).**
4. Confirme no diálogo — a Meta **cobra** por essas conversas quando o comprador não falou com você no WhatsApp recentemente. O custo é da loja, não da Unefesta.

Ao habilitar (ou ao reconectar com a opção já ligada), a Unefesta cria automaticamente os modelos de notificação na sua conta Meta. A **aprovação da Meta** pode levar até cerca de 24 horas.

---

## Como funciona no dia a dia

1. Algo muda no pedido (link de pagamento, confirmação, cancelamento, nova etapa da trilha etc.).
2. A Unefesta **sempre** registra a atualização no **chat do pedido** (Unefesta).
3. Se a opção de notificações estiver ligada, tenta enviar a mesma informação pelo WhatsApp do comprador, usando um **modelo utilitário** aprovado pela Meta.
4. Se faltar algum requisito (modelo ainda não aprovado, sem telefone, WhatsApp desconectado), a mensagem **permanece só no chat Unefesta** — o WhatsApp é apenas omitido.

### O que precisa estar ok para o WhatsApp sair

| Precisa | Observação |
|---------|------------|
| Opção marcada na integração | A caixa de notificações de pedido e pagamento |
| WhatsApp Business **Conectado** | Mesma loja do pedido |
| Modelo aprovado pela Meta | Criação automática; aprovação pode levar até ~24 h |
| Telefone do comprador | No chat ou no perfil do comprador |
| Evento com modelo correspondente | Veja a lista abaixo — outros avisos ficam só no chat |

> **Custo Meta:** modelos utilitários são **grátis** se a [janela de atendimento de 24 horas](../integracao/whatsapp-business-meta.md#janela-de-atendimento-de-24-horas) estiver aberta (o cliente escreveu no WhatsApp recentemente). **Fora** dessa janela — comum em avisos automáticos de checkout e pagamento — a Meta cobra por mensagem entregue. A Unefesta não repassa nem marca margem sobre essas tarifas.

---

## Quais avisos são enviados

Todos usam categoria **utilitária**, em português, com nome do comprador e número do pedido. O texto no WhatsApp é parecido com o do chat Unefesta.

### 1. Link de pagamento disponível

- **Quando:** o link de pagamento do pedido fica pronto (Mercado Pago, PagBank, pedido criado por você etc.).
- **Exemplo no WhatsApp:** “Olá [nome]! O link de pagamento do pedido #… está disponível. Acesse sua conta na loja para concluir.”
- **No chat Unefesta:** “Link de pagamento disponível para o pedido #…”.

### 2. Prazo de pagamento expirado

- **Quando:** o prazo do checkout acaba sem pagamento.
- **Exemplo:** “Olá [nome]! O prazo de pagamento do pedido #… expirou. Entre em contato com a loja se precisar de ajuda.”
- **No chat:** “Pagamento expirado no pedido #…”.

### 3. Pedido cancelado

- **Quando:** o pedido (ou o grupo do pedido) é cancelado.
- **Exemplo:** “Olá [nome]! O pedido #… foi cancelado. Dúvidas? Fale com a loja pelo chat.”
- **No chat:** “Pedido #… foi cancelado.”

### 4. Pagamento recusado

- **Quando:** a cobrança não é aprovada (Mercado Pago ou PagBank — qualquer charge `DECLINED`).
- **Exemplo:** “Olá [nome]! O pagamento do pedido #… não foi aprovado. Tente novamente pelo link do pedido: entre na sua conta do meio de pagamento (Mercado Pago ou PagBank) ou escolha outro meio, como Pix.”
- **No chat:** “Pagamento recusado no pedido #…. Tente novamente…” (orientação pode variar levemente por gateway).
- **E-mail:** slug `order_payment_error_buyer`, com orientação específica por `paymentGateway` quando disponível.

### 5. Pagamento confirmado

- **Quando:** o pagamento do grupo é confirmado (uma vez por grupo).
- **Exemplo:** “Olá [nome]! Recebemos o pagamento do pedido #…. Obrigado pela compra!”
- **No chat:** “Novo pedido #… - pagamento confirmado.”

### 6. Atualização da trilha de status

- **Quando:** você avança o pedido para uma nova etapa da [trilha de status](./trilha-de-status.md).
- **Exemplo:** “Olá [nome]! Atualização do pedido #…: [nome da etapa].”
- **No chat:** o nome da etapa ou “Atualização do andamento do pedido #…: [etapa].”

### 7. Orçamento proposto

- **Quando:** você cria um pedido/orçamento sem link de pagamento imediato.
- **Conteúdo:** avisa o comprador que há um orçamento do pedido #… para analisar.

### 8. Contrato para ver e aceitar

- **Quando:** o contrato do pedido é gerado e enviado ao comprador.
- **Exemplo:** “Olá [nome]! O contrato do pedido #… está pronto. Toque em Ver e aceitar contrato para abrir e aceitar na Unefesta.”
- **Botão:** **Ver e aceitar contrato** — abre a página do contrato na Unefesta (`/user/orders/{pedido}/contrato`).
- **No chat:** “Contrato disponível para o pedido #…. Você pode aceitar e pagar em qualquer ordem.”

### 9. Cancelamento pela loja (pós-venda)

- **Quando:** a loja cancela o pedido pago (regra Unefesta ≥10 dias).
- **Exemplo:** “Olá [nome]! A loja cancelou o pedido #… com reembolso. Dúvidas? Fale pelo chat Unefesta.”
- **No chat:** mensagem de cancelamento pela loja.

### 10. Reagendamento confirmado

- **Quando:** reagendamento pós-venda é concluído (automático ou aprovado pela loja).
- **Exemplo:** “Olá [nome]! O reagendamento do pedido #… foi confirmado. Confira a nova data na sua conta Unefesta.”
- **No chat:** “Reagendamento confirmado — reserva atualizada.”

### 11. Cobrança extra emitida

- **Quando:** a loja emite (envia) uma cobrança extra — não no rascunho.
- **Exemplo:** “Olá [nome]! Há uma nova cobrança de R$ … no pedido #…. Acesse o pedido na Unefesta para pagar ou contestar.”
- **No chat:** “Nova cobrança adicional de R$ …”.

### 12. Solicitação de pós-venda registrada

- **Quando:** o comprador abre cancelamento, devolução, troca ou reagendamento.
- **Exemplo:** “Olá [nome]! Sua solicitação de pós-venda do pedido #… foi registrada. Acompanhe pelo chat Unefesta.”
- **No chat:** “Nova solicitação de … #…”.

---

## Resumo rápido

| Momento do pedido | Vai para o WhatsApp? |
|-------------------|----------------------|
| Link de pagamento liberado | Sim (se a opção estiver ligada) |
| Checkout expirou | Sim |
| Pedido cancelado | Sim |
| Pagamento não aprovado | Sim |
| Pagamento recebido | Sim |
| Nova etapa na trilha de status | Sim |
| Orçamento enviado ao comprador | Sim |
| Contrato gerado (Ver e aceitar contrato) | Sim (botão com link) |
| Lembrete de orçamento | Sim (quando ativo) |
| Cancelamento pela loja (pós-venda) | Sim |
| Reagendamento confirmado | Sim |
| Cobrança extra emitida | Sim |
| Solicitação de pós-venda registrada | Sim |

---

## O que **não** entra neste envio automático

- **Suas respostas manuais** no chat da loja — seguem o fluxo normal (texto livre na janela de 24 h ou modelos que você criar em **Contatos**).
- **E-mails** de pedido (confirmação, pagamento etc.) — canal separado.
- **Avisos sem modelo correspondente** — ficam só no chat Unefesta (ex.: data da encomenda alterada, substituição de locação).
- **Comprador sem telefone** — a mensagem do chat é criada, mas o WhatsApp não é acionado.

---

## Problemas comuns

| Situação | O que fazer |
|----------|-------------|
| Opção ligada, mas o cliente não recebe no WhatsApp | Confira se o WhatsApp está **Conectado**, se o modelo já foi **aprovado** pela Meta (~24 h) e se o comprador tem telefone. |
| Mensagem só no chat Unefesta | Normal quando falta requisito acima — o chat continua sendo a fonte principal. |
| Quero evitar custo Meta | Desmarque a opção de notificações de pedido; as atualizações seguem só no chat Unefesta. |
| Mudei a etapa e não chegou WhatsApp | Confira a opção na integração e o telefone do comprador; a mensagem deve aparecer no chat do pedido. |

## Relacionados

- [WhatsApp Business (Meta)](../integracao/whatsapp-business-meta.md) — conexão, custos e janela de 24 horas
- [Trilha de status](./trilha-de-status.md) — etapas que disparam o aviso de andamento
- [E-mails e mensagens de sistema](../gerais/emails-e-mensagens-de-sistema.md) — o que vai por e-mail e pelo chat Unefesta (com ou sem WhatsApp)
