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 sistema de atendimento.

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

[CDATA[ function read_cookie(a){var b=a+"=";var c=document.cookie.split(";");for(var d=0;d
[CDATA[ function read_cookie(a){var b=a+"=";var c=document.cookie.split(";");for(var d=0;d