Já pensou por algum momento como seria fantástico executar importantes ações de seu sistema no exato timing em que algo acontece entre seu cliente e seu estabelecimento? Exemplo enviar um push no momento em que o cliente esta de fato no local, ou no momento em que o cliente avalia seu estabelecimento. Através de uma simples configuração de webhooks dentro do WiFire seu sistema pode receber todos os insights.
Caso o termo Webhook não seja muito familiar, sugiro a leitura do artigo “O que são webhooks?“.
Como configurar os webhooks no WiFire?
Assim como as demais configurações, esta é muito simples. Basta seguir os passos abaixo:
- Acessar o menu “Configurações > Integrações”
- Adicionar a url de sua API nos campos Weebhook. (Ex: https://api.meusite.com.br/notificacoes/wifire)
- Clicar em “Salvar”
Pronto, sua aplicação já passará a receber as notificações.
Formato requisições do Webhooks.
Todas as requisições seguirão o seguinte padrão:
- Requisição POST
- Content-type: application/json
Webhooks de Insights:
No caso das requisições para webhooks de Insights a estrutura do json seguira o seguinte padrão:
{
“type”: “cliente-conectou”, /*Tipo da notificações. Veja os tipos disponíveis na tabela abaixo.*/
“activity”: { /*Dados do Ingight.*/
“message”: “Lincoln acaba de SE CONECTAR.”,
“data_of_type”: null, /*Informações especificas do tipo em questão.*/
“created_at”: “2017-11-14 16:21:50”
},
“establishment”: { /*Dados do Estabelecimento onde evento ocorreu.*/
“identifier”: “botecodowifire”,
“name”: “Boteco do WiFire”,
“slug”: “boteco-do-wifire”
},
“user”: {
“id”: “29”,
“name”: “Lincoln Fernandes”,
“facebook_id”: “99999999999999”,
“google_id”: “987987987987987987987”,
“image”: “https://exemplo/photo.jpg”,
“email”: “lincoln@velociti.com”,
“status_email”: “valid”,
“cpf”: “99999999999”,
“rg”: “99999999”,
“phone”: “44 9 99999999”,
“mac”: “AA:99:CC:99:99:TT”,
“birthday”: “1988-08-11”
}
}
Tipos disponíveis de Insights:
| Tipo | Descrição |
| cliente-chegou | Cliente esta a mais de 15 minutos no local porém não se conectou na Wi-Fi. |
| cliente-aniversariante-chegou | Cliente que esta fazendo aniversário esta a mais de 15 minutos no local porém não se conectou na Wi-Fi. |
| cliente-primeira-visita | Cliente veio ao estabelecimento pela primeira vez. |
| cliente-voltou-apos-60-dias | Ciente que não vinha a mais de 60 dias no estabelecimento voltou. |
| cliente-tirou-foto | Cliente tirou uma foto no local. |
| cliente-curtiu-campanha | Cliente curtiu uma campanha realizada no WiFire. |
| cliente-curtiu-produto | Cliente curtiu um produto cadastrado no WiFire. |
| cliente-comentou-campanha | Cliente realizou um comentário em uma campanha realizada no WiFire. |
| cliente-comentou-produto | Cliente realizou um comentário em um produto cadastrado no WiFire. |
| cliente-avaliou-negativamente | Cliente realizou uma avaliação com nota entre 0 e 6. |
| cliente-avaliou-passivamente | Cliente realizou uma avaliação com nota entre 7 e 8. |
| cliente-avaliou-positivamente | Cliente realizou uma avaliação com nota entre 9 e 10. |
| cliente-enviou-mensagem | Cliente enviou uma mensagem (tréplica) em uma avaliação. |
| cliente-frequente-chegou | Cliente que frequentemente vem ao estabelecimento esta a mais de 15 minutos no local porém não se conectou na Wi-Fi. |
| cliente-insatisfeito-chegou | Cliente que se mostrou insatisfeito em sua última avaliação esta a mais de 15 minutos no local porém não se conectou na Wi-Fi. |
| cliente-fez-checkin | Cliente acaba de realizar checkin utilizando o WiFire. |
| cliente-curtiu | Cliente acaba de curtir a página do estabelecimento no facebook utilizando WiFire. |
| cliente-conectou | Cliente acaba de se autenticar na Wi-Fi. |
| cliente-aniversariante-conectou | Cliente que esta fazendo aniversário acaba de se autenticar na Wi-Fi. |
| cliente-conectou-primeira-vez | Cliente esta se autenticando na Wi-Fi do estabelecimento pela primeira vez. |
| cliente-conectou-apos-60-dias | Cliente que não vinha ao estabelecimento a mais de 60 dias acaba de se autenticar na Wi-Fi. |
| cliente-frequente-se-conectou | Cliente que frequentemente vem ao estabelecimento acaba de se autenticar na Wi-Fi. |
| cliente-insatisfeito-se-conectou | Cliente que se mostrou insatisfeito em sua última avaliação acaba de se autenticar na Wi-Fi. |
| cliente-sorteado | Cliente acaba de ser sorteado (Sorteio de Vouchers do WiFire) |
Webhooks LGPD:
No caso das requisições para webhooks sobre alterações de dados do usuário para o cumprimento da LDPG a estrutura do json seguira o seguinte padrão:
{
“type”: “cliente-atualizou-conta”,
“establishment”: {
“identifier”: “botecodowifire”,
“name”: “Boteco do WiFire”,
“slug”: “boteco-do-wifire”
},
“user”: {
“id”: “29”,
“name”: “Lincoln Fernandes”,
“email”: “lincoln@velociti.com”,
“phone”: “44 9 99999999”,
}
}
Tipos disponíveis de Webhooks LGPD:
| Tipo | Descrição |
| cliente-atualizou-conta | Cliente atualizou qualquer informação de sua conta. |
| cliente-removeu-conta | Cliente excluiu sua conta. |
Faça seu comentário