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 HTTP/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 HTTP 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 HTTP/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 $HTTP_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":"http://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":"http://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."
                }
            ]
        }
    }