WhatsApp Integration
Integracao com WhatsApp para envio de notificacoes automaticas aos clientes.
Descricao
O sistema envia mensagens automaticas via WhatsApp em momentos-chave do atendimento, como confirmacao de agendamento, aviso de servico concluido e lembretes.
Configuracao
WhatsappConfig
| Campo | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
| provider | Selecao | Sim | Provedor de API |
| api_key | Texto | Sim | Chave de API |
| phone_number | Texto | Sim | Numero remetente |
| active | Booleano | Sim | Se esta ativo |
Provedores Suportados
| Provedor | Descricao |
|---|---|
| twilio | Twilio WhatsApp API |
| z_api | Z-API |
| evolution | Evolution API |
| wppconnect | WPPConnect |
Templates de Mensagem
WhatsappTemplate
| Campo | Tipo | Descricao |
|---|---|---|
| name | Texto | Nome do template |
| event | Selecao | Evento que dispara |
| message | Texto | Texto da mensagem |
| active | Booleano | Se esta ativo |
Eventos Disponiveis
| Evento | Momento |
|---|---|
| appointment_created | Agendamento criado |
| appointment_reminder | Lembrete de agendamento |
| appointment_checkin | Check-in realizado |
| appointment_checkout | Servico concluido |
| sale_completed | Venda finalizada |
| delivery_dispatched | Entrega saiu |
| delivery_completed | Entrega realizada |
| birthday | Aniversario do cliente/pet |
Variaveis
| Variavel | Substituicao |
|---|---|
{cliente_nome} | Nome do cliente |
{pet_nome} | Nome do pet |
{data} | Data do agendamento |
{hora} | Hora do agendamento |
{servicos} | Lista de servicos |
{valor} | Valor total |
{loja_nome} | Nome da loja |
{loja_telefone} | Telefone da loja |
{loja_endereco} | Endereco da loja |
Exemplo de Template
Ola [cliente_nome]!
O banho do(a) [pet_nome] foi concluido!
Voce ja pode vir busca-lo(a) na [loja_nome].
Horario de funcionamento: 8h as 19h
Endereco: [loja_endereco]
Obrigado pela preferencia!
Notificacoes
WhatsappNotification
| Campo | Tipo | Descricao |
|---|---|---|
| phone | Texto | Telefone destino |
| message | Texto | Mensagem enviada |
| status | Selecao | Status do envio |
| sent_at | DataHora | Data/hora do envio |
| delivered_at | DataHora | Data/hora da entrega |
| error | Texto | Mensagem de erro |
Status
| Status | Descricao |
|---|---|
| queued | Na fila |
| sending | Enviando |
| sent | Enviado |
| delivered | Entregue |
| read | Lido |
| failed | Falhou |
Fluxo de Envio
Lembretes
Configuracao de Lembretes
| Campo | Tipo | Descricao |
|---|---|---|
| reminder_enabled | Booleano | Ativa lembretes |
| reminder_hours | Numero | Horas antes |
| reminder_template | Referencia | Template a usar |
Exemplo
Lembrete configurado: 24 horas antes
Agendamento: 15/01 as 14:00
Lembrete enviado: 14/01 as 14:00
Mensagem:
"Ola Maria! Lembrando que amanha (15/01) as 14:00
temos o banho do Rex agendado. Ate la!"
Horarios de Envio
Restricoes
| Configuracao | Descricao |
|---|---|
| start_hour | Hora inicial (ex: 8h) |
| end_hour | Hora final (ex: 20h) |
| weekend_enabled | Envia fim de semana |
Comportamento
Mensagens fora do horario:
- Ficam em fila
- Enviadas no proximo horario valido
Opt-out
Descadastramento
Cliente pode solicitar nao receber mensagens:
| Campo | Descricao |
|---|---|
| whatsapp_optout | Se optou por nao receber |
| optout_date | Data do descadastramento |
Palavras de Opt-out
Se cliente responder:
- "SAIR"
- "PARAR"
- "CANCELAR"
Sistema marca como opt-out automaticamente.
Relatorios
Metricas
| Metrica | Descricao |
|---|---|
| Total enviados | Quantidade de envios |
| Taxa de entrega | % entregues |
| Taxa de leitura | % lidos |
| Taxa de falha | % falharam |
Por Periodo
| Dado | Descricao |
|---|---|
| Envios por dia | Grafico diario |
| Por tipo de evento | Agrupado por evento |
| Por loja | Agrupado por filial |
Validacoes
| Campo | Regra |
|---|---|
| phone | Formato valido (+55...) |
| message | Maximo 4096 caracteres |
| template | Deve existir |
Regras de Negocio
Limite de Envios
| Regra | Valor |
|---|---|
| Por dia/cliente | Maximo 5 mensagens |
| Por hora | Maximo 100 mensagens |
| Intervalo minimo | 1 minuto entre mensagens |
Reenvio
| Situacao | Acao |
|---|---|
| Falha de envio | Tenta 3 vezes |
| Numero invalido | Marca e nao reenvia |
| Timeout | Reagenda em 5 minutos |
Permissoes
| Acao | Descricao |
|---|---|
| Configurar | Configurar integracao |
| Visualizar | Ver notificacoes |
| Enviar manual | Enviar mensagem manual |
| Relatorios | Ver relatorios |