Notificações em tempo real no seu sistema através de Webhooks no WiFire

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