API de Notificação

A API de notificação permite uma integração do chat ativa, ou seja,  os dados do Tolvnow (atendimentos, contatos, abandonos) são automaticamente enviados a outros sistemas (webhooks) através de um https/POST em formato JSON.

A API de notificação está disponível para todas as contas do Tolvnow que operam no Plano Avançado.

Para ativar a API de Notificação, siga os passos:

Administração tolvnow

1. Acesse a área de administração de sua conta

2. Na guia esquerda, clique em Configurações

3. Localize a direita, a separação Integrações

4. Acesse a opção API de Notificação

5. Marque o checkbox Ativar API de notificação.

6. Nos campos de texto, informe a URL que você deseja que os dados sejam enviados, de acordo com suas necessidades.

7. A API de notificação faz o envio das informações alguns instantes após o evento (abandono, contato ou atendimento finalizado), sendo que o tempo do envio pode variar de 1 a 5 minutos após ocorrido. Seu sistema deverá enviar uma resposta https código 200. Caso outro código de resposta seja enviado, ou a requisição ultrapasse o timeout de 10 segundos para responder,  o Tolvnow irá efetuar uma nova tentativa de post em um intervalo de 1 a 3 minutos.

8. A requisição é disparada com o método https/POST, e os dados são enviados no formato JSON no corpo da requisição com encoding UTF-8. Se você utiliza a tecnologia PHP em seu sistema, os dados poderão ser recebidos através da viariável $https_RAW_POST_DATA. Dica: a função json_decode do PHP converte uma string json em um objeto, facilitando a sua manipulação.

Abaixo colocamos exemplos de dados enviados para que você possa usar como exemplo no desenvolvimento.

Notificação de contato (fale conosco)

{  
    "datahora":"2015-03-15 22:15:03",
    "ip":"201.21.45.26",
    "browser":"Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_10_2) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/41.0.2",
    "idfaleconosco":"72182",
    "forms":{  
        "faleconosco":[  
            {  
                "pergunta":"Setor",
                "resposta":"1"
            },
            {  
                "pergunta":"Nome",
                "resposta":"Joao Silva"
            },
            {  
                "pergunta":"Email",
                "resposta":"joao@hotmail.com"
            },
            {  
                "pergunta":"Mensagem",
                "resposta":"Gostaria de ajuda com a integra\u00e7\u00e3o da API."
            },
            {  
                "pergunta":"Telefone",
                "resposta":"(51) 3237.1168"
            }
        ]
    }
}

Notificação de abandono

{  
    "idfilaespera":"318248",
    "idsetores":"1",
    "dt_inicio":"2015-03-06 14:41:05",
    "nome":"Joao Silva",
    "email":"joao@hotmail.com",
    "ip":"120.120.120.1",
    "host":"179-106-82-62.redenets.com.br",
    "browser":"Mozilla\/5.0 (Windows NT 6.1; rv:35.0) Gecko\/20100101 Firefox\/35.0",
    "idioma":"pt-BR,pt;q",
    "referer":"https://www.google.com",
    "paginaatual":"https://www.tolvnow.com",
    "forms":{  
        "identificacao":[  
            {  
                "pergunta":"Nome",
                "resposta":"Joao Silva"
            },
            {  
                "pergunta":"Email",
                "resposta":"joao@hotmail.com"
            },
            {  
                "pergunta":"Telefone",
                "resposta":"(51) 3237-1168"
            },
            {  
                "pergunta":"Onde nos conheceu?",
                "resposta":"Google"
            }
        ]
    }
}

Notificação de atendimento

{  
    "idatendimento":"325910",
    "dt_inicio_fila":"2015-03-11 10:15:49",
    "dt_inicio":"2015-03-11 10:15:56",
    "dt_final":"2015-03-11 10:18:01",
    "dt_final_operacao":"2015-03-11 10:47:42",
    "nome":"Joao Silva",
    "email":"joao@hotmail.com",
    "ip":"200.205.241.106",
    "host":"200-205-241-106.customer.tdatabrasil.net.br",
    "browser":"Mozilla\/5.0 (Windows NT 6.1; WOW64; Trident\/7.0; rv:11.0) like Gecko",
    "idioma":"pt-BR",
    "pais":"BR",
    "regiao":"RS",
    "cidade":"Porto Alegre",
    "referer":"https://www.google.com",
    "idusuario":"0",
    "idsetores":"1",
    "paginaatual":"https://www.tolvnow.com",
    "anotacoes":"",
    "encerramento":"Cliente saiu do chat",
    "mensagens":[  
        {  
            "idusuario":"2",
            "dt":"2015-03-11 10:15:56",
            "msg":"Olá! Precisando de um sistema de chat para seu site ?",
            "idsetores":"1",
            "interna":"0",
            "supervisor":"0"
        },
        {  
            "idusuario":"cliente",
            "dt":"2015-03-11 10:15:56",
            "msg":"Sim. Podem me ajudar ?",
            "idsetores":"1",
            "interna":"0",
            "supervisor":"0"
        },
        {  
            "idusuario":"2",
            "dt":"2015-03-11 10:16:15",
            "msg":"Sim, claro. Voce ja criou sua conta no tolvnow.com ?",
            "idsetores":"1",
            "interna":"0",
            "supervisor":"0"
        }
    ],
    "forms":{  
        "identificacao":[  
            {  
                "pergunta":"Nome",
                "resposta":"Joao Silva"
            },
            {  
                "pergunta":"Email",
                "resposta":"joao@hotmail.com"
            },
            {  
                "pergunta":"Telefone",
                "resposta":"(51) 3237-1168"
            },
            {  
                "pergunta":"Onde nos conheceu?",
                "resposta":"Google"
            }
        ],
        "satisfacao":[  
            {  
                "pergunta":"Seus coment\u00e1rios",
                "resposta":"Muito bom atendimento!"
            },
            {  
                "pergunta":"Qual a sua opini\u00e3o sobre a qualidade de nosso atendimento?",
                "resposta":"Excelente"
            },
            {  
                "pergunta":"Qual \u00e9 a sua opini\u00e3o sobre nosso atendente?",
                "resposta":"Otimo"
            }
        ],
        "atendimento":[  
            {  
                "pergunta":"Observa\u00e7\u00f5es",
                "resposta":"Atendimento otimo."
            }
        ]
    }
}