Integrações personalizadas

Nathan Begbie Atualizado por Nathan Begbie

Por que usar uma integração personalizada?

As integrações personalizadas podem melhorar sua experiência de helpdesk vinculando seu serviço Turn a sistemas externos, como o sistema de gerenciamento de relacionamento com o cliente, seu banco de dados de pacientes ou qualquer serviço externo que você esteja executando.

O que você pode fazer com integrações personalizadas?

  • Ações - permitir que os operadores de helpdesk acionem webhooks externos para uma determinada mensagem
  • Respostas sugeridas - considerando o histórico de mensagens com uma determinada mensagem paciente, gere uma resposta sugerida que um operador de helpdesk pode escolher usar
  • Contexto Adicional - busque dados adicionais e exiba-os na barra lateral do seu aplicativo. Isso é particularmente útil caso você queira armazenar dados de contato adicionais em um armazenamento de dados separado.

Configurando a integração personalizada

Primeiro, navegue até "Configurações" e clique no botão "Integrações" guia e, em seguida, no botão suspenso "Adicionar uma integração", selecione "Integração personalizada"

Neste ponto, você precisa fornecer alguns campos:

Nome: como você identificará a integração relevante.

URL: este é o endpoint que seu a integração personalizada chamará várias cargas JSON. Seu serviço só pode receber cargas neste único endpoint.

Tipo de autenticação HTTP e Token de API: esses recursos são necessários ao configurar uma integração personalizada com Turn.io, mas estão relacionados especificamente ao modo como seu serviço funciona. O Tipo de autorização HTTP pode ser BEARER ou TOKEN. Isso significa apenas que, digamos, por exemplo, você escolheu BEARER e definiu o API Token como 123, então sempre que o Turn fizer uma solicitação ao seu serviço, ele incluirá o cabeçalho HTTP Authorization: Bearer 123 em cada chamada. Isso significa que você pode ter certeza de que o serviço é capaz de verificar se as solicitações vêm do Turn. Se, no entanto, você estiver apenas testando essa funcionalidade e não quiser implementar nenhuma autenticação em seu aplicativo, não precisará se preocupar com o que selecionar ou inserir nesses campos (mas precisará inserir algo).

Depois de selecionar 'Criar integração', o Turn.io tentará enviar um handshake para o serviço que você acabou de criar. Se você ainda não configurou nada, tudo bem. O aperto de mão falhará. Depois de configurar seu serviço, você pode tentar reativar

Implementando sua integração personalizada

Desde que você consiga configurar um serviço que possa receber chamadas HTTP, você poderá integrar com qualquer serviço que desejar. No entanto, fornecemos alguns kits iniciais e exemplos em Javascript e Python

Uso da biblioteca Turn Javascript Integration

Uma das maneiras pelas quais você pode criar uma biblioteca de integração personalizada é usando o pacote Turn npm. A biblioteca exige que você forneça o SECRET que o Turn gera quando cria a integração. Ele usa esse segredo para autenticar as chamadas do Turn.

Um detalhamento muito detalhado das chamadas e respostas que estão disponíveis para você recebe na documentação do desenvolvedor, que recomendamos fortemente que você leia.

Se quiser tentar criar sua própria integração personalizada usando a biblioteca Javascript, use o Repl.it pré-construído que configuramos para você.

Outros exemplos em Python

Existem vários repositórios que criamos como exemplos para experimentar e experimentar. Eles são exemplos prontos para serem executados com Repl.it Clique aqui para ver todos eles.

Se quiser conhecer algumas das funcionalidades disponíveis com integrações personalizadas, você pode usar alguns exemplos de modelos como ponto de partida com:

turnio-duckduckgo-replit - Um exemplo que Turn.io sugeriu integração de resposta no Replit. Isso retornará o resumo da API DuckDuckGo como uma resposta sugerida na IU do Turn.io

turnio-integration-replit - Um exemplo de integração da IU do Turn.io no Replit. Isso amplia a UI do Turn com uma resposta rápida, informações de perfil personalizadas e menus de ação.

Esse artigo foi útil?

Solução de problemas de webhook

Como configurar uma integração RapidPro

Contato