Passo a passo da integração entre Atende Simples e Octadesk

By 10 de janeiro de 2017OctaNews
integração atende simples e octadesk

Nesse artigo, vamos te explicar como configurar e usar a API do Octadesk para integração com o serviço de telefonia do Atende Simples.

Configuração no Atende Simples

Configuração WebHook

Na tela inicial, acesse o menu de integrações:

integração atende simples e octadesk

Em seguida, acesse o menu do Webhook:

integração atende simples e octadesk

Clique em “Novo webhook”:

integração atende simples e octadesk

Depois, informe a Url da API do Octadesk para o Webhook da seguinte forma:

http://<seusubdomínio>.octadesk.store/api/AtendeSimples/getWebHook</seusubdomínio>

Nota: o valor do <SeuSubDomínio> será substituído pelo subdomínio do seu Octadesk criado para receber os tickets.

Marque a opção “Todos Eventos de Chamada”:

integração atende simples e octadesk

Após a criação do WebHook, será necessário “enviar um ping” para que o Atende Simples possa reconhecer a aplicação. Isso pode ser feito clicando no botão “enviar ping”.

integração atende simples e octadesk

Ao enviar o ping, é necessário que apareça uma resposta semelhante a da imagem abaixo:

integração atende simples e octadesk

Ou seja, se teve a resposta com “status 200”, é porque a aplicação foi reconhecida corretamente.

Configuração de Interação

Com o WebHook ativado, será necessário cadastrar um fluxo de chamada que irá ser usado para identificação do cliente no Octadesk.

Como sugestão de configuração, foram criadas duas opções de menu:

  • Na opção 1, será solicitada ao cliente uma identificação;
  • Na opção 9, foi criado o “reencaminhar para um atendente”;

Na opção 9, será reencaminhada a ligação para um atendente.

integração atende simples e octadesk

Atenção: O atendente da ligação tem que estar cadastrado como “Agente” no Octadesk. Como a identificação do atendente é feita por e-mail, o valor deste campo tem que ser igual em ambos os sistemas.

Na opção 1, para conseguir identificar o cliente, é necessário informar qual método da API do
Octadesk deseja usar. Entre eles:

  • CustomerCode: http://<SeuSubDomínio>.octadesk.store/api/AtendeSimples/getInteractionByCustomerCode

Atenção: Esse método busca uma informação de código do cliente. Entretanto, essa informação é interna do Octadesk e o campo e não pode ser manipulado pelo cliente.

  • CPF:
    http://<SeuSubDomínio>.octadesk.store/api/AtendeSimples/getInteractionByCPF
  • CNPJ:
    http://<SeuSubDomínio>.octadesk.store/api/AtendeSimples/getInteractionByCNPJ
  • CPF ou CNPJ:
    http://<SeuSubDomínio>.octadesk.store/api/AtendeSimples/getInteractionByCPFCNPJ
  • Telefone:
    http://<SeuSubDomínio>.octadesk.store/api/AtendeSimples/getInteractionByNumberPhone

OBS.: Para que a integração funcione, é necessário criar os campos CPF, CNPJ e Telefone como campos personalizados no Octadesk.

No exemplo, está sendo utilizada a API com link para buscar o cliente através do CPF.

integração atende simples e octadesk

Clique na opção “Consultar uma API externa” e informe o endereço conforme descrito acima.

integração atende simples e octadesk

Será necessário fazer uma validação. Para isso, basta informar qualquer número e clicar em “validar”. Caso obtenha sucesso, será mostrada uma mensagem semelhante a esta:

integração atende simples e octadesk

Configuração de Pré Chamada

Existe também a possibilidade de identificar o cliente, caso o campo customizado “telefone” no Octadesk esteja preenchido com o telefone que o cliente usa para entrar em contato com o sistema de telefonia do Atende Simples. Para isso, no Menu, acesse a opção de “Atendimento > Pré Chamada”.

integração atende simples e octadesk

Selecione a opção “Consultar uma API externa” e coloque o endereço URL no formato http://<SeuSubDomínio>.octadesk.store/api/AtendeSimples/getPreCall.

Será necessário fazer uma validação, para isso, basta informar qualquer número e clicar em “validar”.

Caso obtenha sucesso, será mostrada uma mensagem semelhante a esta:

integração atende simples e octadesk

Atenção: A pré chamada só funciona com o menu de interação, conforme a documentação da funcionalidade no Atende Simples. Dessa forma, caso haja algum problema na identificação inicial do cliente, o fluxo de chamada será acionado automaticamente. Caso seja identificado, o fluxo de cliente atendido( configurado nos settings do AtendeSimples no Octadesk) seguirá.

Configuração dos Settings no Octadesk

Antes de configurar, é necessário habilitar a funcionalidade no MarketPlace, selecionar os usuários que utilizarão o serviço e salvar.

integração atende simples e octadesk

integração atende simples e octadesk

Após ter instalado pelo MarketPlace, vá ao Menu de configuração e acesse “Atende Simples –
Settings”.

integração atende simples e octadesk

É necessário configurar a mensagem que será lida pela central de atendimento quando o cliente for identificado (e também quando não for).

As opções selecionadas indicarão a central de atendimento para onde a ligação será redirecionada. Essas opções têm que estar cadastradas previamente no Atende Simples, como foi descrito acima, no item de configuração do fluxo de chamada.

integração atende simples e octadesk

Alguns cenários serão tratados pelos Octadesk para abertura de ticket (na tela de configuração, tem a explicação de cada item). São eles:

  • Ligações Atendidas: São consideradas ligações atendidas aquelas em que o cliente conversa com um dos agentes de atendimento.
  • Ligações Perdidas: São consideradas ligações perdidas aquelas em que o cliente demanda o atendimento de um agente, mas que não são atendidas.
  • Ligações de Autoatendimento (tratadas): Ligações de autoatendimento são aquelas em que o cliente obtém sua resposta sem a necessidade de interagir com um agente.
  • Ligações Abandonadas: São consideradas ligações abandonadas aquelas em que o cliente desliga sem ter selecionado nenhuma opção no menu de atendimento.

integração atende simples e octadesk

[data-form-submit="regular"]
[data-form-submit="regular"]
[CDATA[ */function read_cookie(a) {var b = a + "=";var c = document.cookie.split(";");for (var d = 0; d < c.length; d++) {var e = c[d]
[CDATA[ */function read_cookie(a) {var b = a + "=";var c = document.cookie.split(";");for (var d = 0; d < c.length; d++) {var e = c[d]
[CDATA[ */function read_cookie(a) {var b = a + "=";var c = document.cookie.split(";");for (var d = 0; d < c.length; d++) {var e = c[d]
[CDATA[ */function read_cookie(a) {var b = a + "=";var c = document.cookie.split(";");for (var d = 0; d < c.length; d++) {var e = c[d]
[data-image-id='gourmet_bg']
[data-image-id='gourmet_bg']
[data-image-id='gourmet_bg']
[data-image-id='gourmet_bg']
[data-image-id='gourmet_bg']
[data-image-id='gourmet_bg']
[data-image-id='gourmet']
[data-image-id='gourmet']
[data-image-id='gourmet']
[data-image-id='gourmet']
[data-image-id='gourmet']
[data-image-id='gourmet']
[data-image-id='gourmet']
[data-image-id='gourmet']
[data-image-id='gourmet']
[data-image-id='gourmet']
[CDATA[*/function read_cookie(a) {var b = a + "=";var c = document.cookie.split(";");for (var d = 0; d < c.length; d++) {var e = c[d]
[CDATA[*/function read_cookie(a) {var b = a + "=";var c = document.cookie.split(";");for (var d = 0; d < c.length; d++) {var e = c[d]