Vivantio

Vivantio é um excelente software para gerenciamento de atendimento ao cliente e oferece funcionalidades integradas para adicionar o envio de SMS em apenas alguns passos. Este documento descreve como isso pode ser implementado.

Configuração

Primeiro, navegamos para Admin → Integração & API → Webhooks.

Selecionar tipo de ticket

Selecione um tipo de ticket no menu suspenso. Neste documento, usamos Incidente.

Definir detalhes básicos

Insira um Nome para descrever a ação. Este também será o texto do botão que aparecerá mais tarde no menu suspenso de ações.

Defina a URL de Requisição para https://gateway.seven.io/api/sms.

Defina o Método HTTP para POST.

Defina o Tipo de Autenticação para Nenhuma Autenticação.

Defina o Tipo de Conteúdo de Resposta para application/json.

Insira uma Descrição da Ação para descrever o que acontece quando esta ação é utilizada.

Parâmetros

Na aba Parâmetros, precisamos adicionar alguns parâmetros de requisição para definir o destinatário da mensagem e o texto da mensagem.

Clique em Adicionar para adicionar um novo parâmetro. Precisamos definir dois deles:

Destinatário

Define o destinatário do SMS.

Defina o Nome para Destinatário.

Certifique-se de que Somente Leitura não está ativado.

Defina o Tipo de Dados para Alfanumérico.

Defina o Tipo de Exibição para Texto Livre.

Defina a Fonte Padrão para ticket.callerphone. Isso define o número de telefone do contato do ticket como destinatário padrão.

Texto

Defina o Nome para Texto.

Certifique-se de que Somente Leitura não está ativado.

Defina o Tipo de Dados para Alfanumérico.

Defina o Tipo de Exibição para Texto Livre (Multilinha).

Deixe a fonte padrão em branco.

Texto da Solicitação

Na aba Texto da Solicitação, precisamos definir como será a carga útil da nossa solicitação de API.

Integração Vivantio

Vivantio é um serviço que ajuda as empresas a gerenciar solicitações de atendimento ao cliente. Com a integração, você pode executar notificações e ações automatizadas diretamente do seu sistema Vivantio.

Definir tipo de conteúdo da solicitação

Defina o tipo de conteúdo da solicitação como application/json.

Definir modelo de corpo

O modelo de corpo deve ser o seguinte:

{
    "from": "optionale Absenderkennung",
    "p": "IHR_API_SCHLÜSSEL",
    "text": "{{text}}",
    "to": "{{to}}"
}

Salvar Webhook

Clique em Salvar para criar seu primeiro webhook.

Selecionar funções

Encontre o botão Funções na barra de ferramentas e clique nele.

Use arrastar e soltar para garantir que Funções Atuais não esteja vazio. Somente usuários atribuídos a essa função poderão usar nosso webhook.

Testar Webhook

Abra um ticket do tipo Incidente e pressione o botão Ações. Clique no botão com o nome que você deu ao webhook recém-criado.

Aparecerá o seguinte popup, onde você pode inserir seu texto SMS no campo Texto.

Se o usuário tiver um número de telefone associado, ele será definido como o valor padrão no campo Destinatário. Você pode adicionar mais destinatários separados por vírgula.

Por fim, pressione OK e seu SMS será enviado!