Como integro a Octadesk com a Atende Simples?
Escrito por Leon
atualizado
Quer saber como configurar e usar a API do Octadesk para integração com o serviço de telefonia do Atende Simples? Vem como a gente que vamos te explicar tudo. o/
Para isso, é necessário que já tenha um plano e conta na Atende Simples e que tenha um perfil de Administrador na Octadesk. Estando tudo certo, vamos aos passos.
Configuração no Atende Simples
Na tela inicial do portal da Atende Simples, acesse o menu de integrações:
Em seguida, clique no menu de Webhooks:
Abra o “Novo Webhook”:
Depois informe a URL da API da Octadesk para o Webhook, você precisa gerar essa URL neste link: https://app.octadesk.com/tickets/apps/voice/atendesimples
No Atende Simples, marque a opção “Todos Eventos de Chamada”:
Após a criação do Webhook, é preciso “Enviar um ping” para que o Atende Simples possa reconhecer a aplicação.
Você pode fazer isso clicando no botão “Enviar ping”.
Ao enviar o ping, deverá aparecer uma resposta semelhante a imagem abaixo:
Ou seja, se a resposta foi “status 200”, a aplicação foi reconhecida corretamente.
Configuração de Interação
Com o Webhook ativado, é preciso cadastrar um fluxo de chamada que irá ser usado para identificação do cliente na Octadesk.
Como sugestão de configuração, foram criadas duas opções de menu:
- Na opção 1, uma identificação é solicitada ao cliente;
- Na opção 9, foi criado o “reencaminhar para um atendente”;
Na opção 9, será reencaminhada a ligação para um atendente.
Atenção: O atendente da ligação precisa estar cadastrado como “Agente” na Octadesk. Como a identificação do atendente é feita por e-mail, o valor deste campo tem que ser igual nos dois sistemas.
Na opção 1, vamos configurar para que o fluxo valide se existe um ticket já criado.
No exemplo, está sendo utilizada a API com link para buscar do ticket através do número do ticket.
Clique na opção “Consultar uma API externa” e informe o endereço conforme foi dito acima.
Para ter a URL a configuração precisa:
Copiar a URL no link do atendesimples dentro do octadesk (https://app.octadesk.com/tickets/apps/voice/atendesimples)
Com a URL copiada, precisamos deixar ela com o seguinte padrão:
Manter a parte inicial da URL, https://southamerica-east1-001.prod.octadesk.services/tickets/voice
Adicionar na URL, /api/events/verify/ticket/
Adicionar o subdomain, o999999-999
O final o que é esperado que aconteça nos 3 casos:
Sucesso o ticket existe, ok=(número de sucesso)
Não achou o ticket, nok=(número de falha)
Caso tenha algum erro, error=(número de erro)
Os números retornados são os que você irá configurar no atende simples como opção.
Ao final você terá uma URL desta forma:
https://southamerica-east1-001.prod.octadesk.services/tickets/voice/api/events/verify/ticket/o999999-999?ok=100&nok=255&error=999
Nesse exemplo, a integração vai olhar para o valor digitado no telefone e vai retornar ao atende simples 100 caso encontre o ticket, 255 se não encontrar e 999 caso ele tenha algum problema na busca.
Agora, é preciso fazer uma validação. Para isso, basta informar qualquer número de ticket e e clicar em “validar”.
Em caso positivo, uma mensagem semelhante a esta vai aparecer na tela:
Configuração de pré-chamada
Existe também a possibilidade de identificar o cliente, caso o campo customizado “Telefone” na 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”.
Selecione a opção “Consultar uma API externa” e insira o endereço URL no formato http://<SeuSubDomínio>.octadesk.store/api/AtendeSimples/getPreCall.
Também é preciso fazer uma validação. Para isso, basta informar qualquer número e clicar em “Validar”.
Em caso positivo, uma mensagem semelhante a essa será:
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 Atende Simples no Octadesk) seguirá.
Configuração no Octadesk
Localize no menu de Tickets a seção Canais, e dentro dela, a opção “AtendeSimples”.
É preciso 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 vão indicar 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.
Alguns cenários serão tratados pelo 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.
Para configurar basta preencher os campos de acordo com a sua necessidade.