WhatsApp & SMS Notifications
Envie notificações por WhatsApp ou SMS para eventos de pedido, carrinhos abandonados e mais.
Visão geral
Fluxo:
- Admin configura URLs de gateway em Settings.
- Admin cria templates de notificação em Products → Notifications (ou similar).
- Quando os triggers são acionados (ex.: pedido feito, fatura paga, carrinho abandonado), o módulo envia uma requisição ao gateway.
- O gateway entrega a mensagem via WhatsApp ou SMS.
Configuração
URLs de Gateway
- Vá em Setup → Settings → Products.
- Em WhatsApp / SMS Notifications:
- Ative o recurso.
- Digite SMS Gateway URL – Endpoint de webhook/API do seu provedor de SMS.
- Digite WhatsApp Gateway URL – Endpoint de webhook/API do seu provedor de WhatsApp.
- Salve.
Sobrescrita por template
Cada template de notificação pode usar o gateway global ou uma URL de webhook personalizada.
Criando um template de notificação
- Vá em Products → Notifications (ou Product Notifications).
- Clique em New Notification.
- Configure:
| Field | Description |
|---|---|
| Name | Nome interno |
| Channel | WhatsApp ou SMS |
| Trigger | abandoned_cart, order_placed, order_paid |
| Recipient | client ou staff |
| Message template | Texto com merge fields |
| Webhook URL | Sobrescrever global (opcional) |
| Webhook method | POST ou GET |
| Webhook body | Template JSON para a API |
- Salve.
Merge Fields
Use estes placeholders no template de mensagem:
| Field | Description |
|---|---|
| {companyname} | Nome da sua empresa |
| {cart_link} | Link para o checkout |
| {cart_total} | Total do carrinho (carrinho abandonado) |
| {client_name} | Nome do cliente |
| {contact_phonenumber} | Número de telefone |
| {order_id} | Order ID |
| {order_date} | Data do pedido |
| {total} | Total do pedido |
| {invoice_number} | Número da fatura |
| {invoice_link} | Link para a fatura |
Eventos de trigger
- abandoned_cart – Quando o cron envia lembretes de carrinho abandonado.
- order_placed – Quando um pedido/fatura é criado.
- order_paid – Quando uma fatura é marcada como paga.
Webhook Body
O formato padrão do body é frequentemente:
{"to":"{contact_phonenumber}","body":"{message}"}
O placeholder {message} é substituído pela mensagem renderizada (codificada em JSON). Ajuste o template do body para corresponder aos requisitos da API do seu gateway.