A estrutura de chatbot da Workvivo foi projetada para transformar a maneira como as organizações interagem e se envolvem com seus funcionários, permitindo conversas fluidas, intuitivas e impactantes por meio de uma plataforma de chatbot avançada e personalizável.
Isso permite que as organizações criem experiências de chatbot personalizadas que vão além de simples respostas de texto, aprimorando as interações no chat com elementos multimídia e interativos.
Dispositivo(s): Web, Móvel
Funções/Permissões: Administrador e Desenvolvedor
Disponibilidade: acesso geral
Observação: disponível apenas para clientes que tenham o complemento de Chat. Fale com seu representante de sucesso do cliente para mais informações
- Admin cria fluxo de bot
- Publicado em developer.workvivo.com
- Nova conversa de bot
- Sair da conversa
- Modelo de texto e mídia
Configuração inicial da API:
Para usar a API da Workvivo, primeiro você deve entrar em contato com o suporte para solicitar acesso à API. Consulte developer.workvivo.com para saber mais
- Use APIs do Workvivo com um token Bearer
- Manipule solicitações de webhook do Workvivo.
- Verifique a autenticidade das solicitações de webhook usando um JWT fornecido pelo Workvivo.
Autorização para APIs Workvivo
Para interagir com as APIs da Workvivo, você precisa de um token de portador para autorização. Inclua o token no cabeçalho "Authorization" ao fazer solicitações. Mais detalhes sobre isso estão disponíveis aqui.
Escopos necessários
Os seguintes escopos são necessários para usar as APIs do Workvivo para interações de chatbot:
chats.bots.read – Para ler informações e configurações do chatbot.
chats.bots.write – Para criar chatbots e atualizar a configuração de um chatbot.
chats.message.write - Para criar mensagens no chat do workvivo.
Lidando com solicitações de webhook do Workvivo
Quando um usuário interage com um chatbot no Workvivo, o Workvivo envia uma solicitação POST para o URL do webhook especificado durante a criação do bot. Esta solicitação inclui um JWT no cabeçalho x-workvivo-jwt para verificar a autenticidade da solicitação.
Formato de solicitação de webhook
Método HTTP: POST
Tipo de conteúdo: aplicativo/json
Cabeçalho do Webhook
x-workvivo-jwt: JWT gerado pelo Workvivo
Mídia em chatbots
- Para especificações sobre anexos em chatbots, consulte aqui
Observações:
Isso permite enviar um arquivo por mensagem
Os chatbots permitem os seguintes tipos de arquivo
- Tipos de imagem MIME: gif, png, jpg, jpeg, jfif
- Tipos de vídeo Mime: vídeo/mp4, videp/x-m4v
-
Arquivo: nenhuma restrição de tipo de arquivo com base nos tipos MIME permitidos. Exceção de erro ao enviar uma imagem ou um vídeo.
- As miniaturas também podem ser adicionadas ao vídeo.
- Tamanho máximo: 128 MB
"Exemplos:"
.
.
Habilitando o recurso do chatbot
Chatbots podem ser habilitados diretamente no painel de administração do seu ambiente ativando a configuração abaixo:
Se precisar de assistência, entre em contato com seu representante da Workvivo para fazer a ativação para você.
Criando um chatbot no Chat Admin
Navegue até Administração > Administração de chat > Gerenciar bots
Selecione "Adicionar bot de bate-papo"
- Adicione o apelido do bot, por exemplo "Helpdesk"
- Adicione a URL da imagem do bot para dar ao bot um avatar no chat
- Selecione um tipo de bot - Esta é uma categoria na qual o bot reside - por exemplo, produtividade
- Adicione o URL de retorno do bot
Selecione o público
- Isso determinará quem terá acesso para se comunicar com este Bot
- O modo global é definido por padrão, os administradores podem selecionar várias equipes
- Selecione "Salvar"
Uma vez salvo
- O bot está desabilitado por padrão - alterne para habilitar
A partir daqui você pode editar ou excluir o bot