COSMO Bot (Pré-visualização)
O COSMO Bot aumenta o sucesso do seu negócio através de mais eficiência na vida quotidiana. Se você responder a uma pergunta padrão hoje, você está perdendo tempo. Em contacto com os seus clientes, esta é muitas vezes uma boa oportunidade para se conhecerem e estabelecerem uma relação. Mas internamente, de funcionário para funcionário, ou quando há simplesmente muito a fazer, é um luxo que nem todos se podem permitir. Esse conector permite estender a funcionalidade do bot e integrar outros sistemas.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte COSMO CONSULT |
| URL | https://de.cosmoconsult.com/service/support/ |
| support.west@cosmoconsult.com |
| Metadados do conector | |
|---|---|
| Editora | COSMO CONSULT GmbH |
| Sítio Web | https://cosma.link/cc-bot |
| Política de privacidade | https://www.cosmoconsult.com/data-protection/ |
| Categorias | IA; Comunicação |
Pré-requisitos
Para usar esse conector, você precisa ter acesso administrativo a uma instância do COSMO Bot. O que é o COSMO Bot?Como faço para obter uma instância do COSMO Bot?
Como obter credenciais?
Depois de ter acesso administrativo a uma Instância do COSMO Bot, vá para a interface do chat (ou seja https://cosma.cosmoconsult.com/, ) e mude para a guia "Administração" clicando em "Administração" no canto superior direito. Navegue até "Chaves de API" e crie uma nova ou copie uma existente.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| URL da instância do bot | cadeia (de caracteres) | A URL onde sua instância de bot pode ser acessada | Verdade |
| Chave de API | securestring | A chave de API para acessar essa instância de bot | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Abrir um ticket (feedback) |
Abra um novo tíquete de feedback de tipo na instância conectada. |
| Abrir um ticket (pergunta) |
Abra um novo tíquete na instância conectada. |
| Adicionar um especialista a um tópico |
O bot adicionará o especialista ao tópico fornecido. |
| Adicionar um novo conjunto de perguntas e respostas |
Adiciona um novo conjunto de perguntas e respostas à instância conectada. |
| Adicionar um novo tópico |
Adiciona um novo tópico à instância conectada. |
| Converter COSMO Bot Script |
Execute o texto fornecido através do analisador de script COSMO Bot. |
| Criar uma cópia de sombra de um conjunto de perguntas e respostas |
Adiciona uma nova cópia de sombra para o conjunto de perguntas e respostas especificado pela breve descrição. Cuidado! Essas cópias de sombra são excluídas quando a resposta é atualizada. Portanto, recomenda-se chamar automaticamente essa ação usando o gatilho "quando um conjunto de perguntas-respostas é atualizado". |
| Definição da palavra (markdown friendly) |
Traduza o texto dado respeitando a sintaxe do dialeto Markdown do COSMO Bot. |
| Editar um conjunto de perguntas e respostas existente |
Edite um conjunto de perguntas e respostas existente a partir da instância conectada. |
| Excluir um conjunto de perguntas e respostas |
Exclua um conjunto de perguntas e respostas existente da instância conectada. |
| Faça uma pergunta ao COSMO Bot |
O bot pesquisará através da base de conhecimento e retornará a resposta com a melhor correspondência. Também retorna a pontuação. |
| Fechar um ticket |
Fecha um tíquete aberto na instância conectada. |
| Obtenha especialistas para um tópico |
Obtém todas as exposições da instância conectada. |
| Obter bilhetes abertos |
Obtém todos os tíquetes abertos da instância conectada. |
| Obter configurações globais |
Obtém as configurações globais da instância conectada. |
| Obter todos os conjuntos de perguntas e respostas |
Obtém todas as respostas da instância conectada. |
| Obter todos os tópicos |
Obtém todos os tópicos da instância do bot conectado. |
| Obter tópico |
Obtém um tópico específico da instância conectada. |
| Remover um especialista de um tópico |
O bot removerá um especialista do tópico fornecido. Se nenhum tópico for dado, o especialista será removido de todos os tópicos. |
| Renomear um tópico existente |
Renomeie um tópico existente da instância conectada. |
Abrir um ticket (feedback)
Abra um novo tíquete de feedback de tipo na instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
E-mail do usuário
|
userEmail | True | string | |
|
Pergunta que foi feita pelo usuário
|
queryText | True | string | |
|
Breve descrição da resposta
|
answerShortDescription | True | string | |
|
Comentários sobre a resposta
|
feedbackText | True | string |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhete
|
ticket | Ticket |
Abrir um ticket (pergunta)
Abra um novo tíquete na instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
E-mail do usuário
|
userEmail | True | string | |
|
Pergunta que foi feita pelo usuário
|
queryText | True | string | |
|
Tópico ao qual esta pergunta provavelmente pertence
|
topic | string |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhete
|
ticket | Ticket |
Adicionar um especialista a um tópico
O bot adicionará o especialista ao tópico fornecido.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tópico
|
topic | True | string | |
|
E-mail de especialista
|
expertEmail | True | string |
Adicionar um novo conjunto de perguntas e respostas
Adiciona um novo conjunto de perguntas e respostas à instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tópico
|
topic | True | string | |
|
Breve Descrição
|
shortDescription | True | string | |
|
Perguntas
|
questions | True | array of string | |
|
Texto da resposta
|
answerText | True | string | |
|
E-mail do usuário
|
userEmail | string |
Adicionar um novo tópico
Adiciona um novo tópico à instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
name | True | string | |
|
Description
|
description | True | string | |
|
E-mails de especialistas
|
expertEmails | True | array of string |
Converter COSMO Bot Script
Execute o texto fornecido através do analisador de script COSMO Bot.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Texto de entrada
|
inputText | True | string | |
|
Formato de saída
|
outputFormat | True | string |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto de saída
|
outputText | string |
O texto analisado retornado pelo COSMO Bot Script Parser. |
Criar uma cópia de sombra de um conjunto de perguntas e respostas
Adiciona uma nova cópia de sombra para o conjunto de perguntas e respostas especificado pela breve descrição. Cuidado! Essas cópias de sombra são excluídas quando a resposta é atualizada. Portanto, recomenda-se chamar automaticamente essa ação usando o gatilho "quando um conjunto de perguntas-respostas é atualizado".
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Breve Descrição da Resposta Original
|
shortDescription | True | string | |
|
Breve Descrição do Shadow Copy
|
subShortDescription | True | string | |
|
Perguntas
|
subQuestions | True | array of string | |
|
Texto da resposta
|
subAnswerText | True | string |
Definição da palavra (markdown friendly)
Traduza o texto dado respeitando a sintaxe do dialeto Markdown do COSMO Bot.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Língua de chegada
|
targetLanguageCode | True | string |
O código da língua de chegada (exemplo: fr). |
|
Texto
|
inputText | True | string |
O texto a traduzir. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto traduzido
|
outputText | string |
Editar um conjunto de perguntas e respostas existente
Edite um conjunto de perguntas e respostas existente a partir da instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Breve descrição do conjunto existente
|
shortDescription | True | string | |
|
Tópico atualizado
|
newTopic | string | ||
|
Breve Descrição Atualizada
|
newShortDescription | string | ||
|
Perguntas atualizadas
|
newQuestions | array of string | ||
|
Texto da resposta atualizado
|
newAnswerText | string | ||
|
E-mail do usuário
|
userEmail | string |
Excluir um conjunto de perguntas e respostas
Exclua um conjunto de perguntas e respostas existente da instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Breve Descrição
|
shortDescription | True | string |
Faça uma pergunta ao COSMO Bot
O bot pesquisará através da base de conhecimento e retornará a resposta com a melhor correspondência. Também retorna a pontuação.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Question
|
question | True | string | |
|
Limiar de pontuação
|
scoreThreshold | integer |
Pontuação mínima de uma resposta para que seja devolvida. |
|
|
E-mail do usuário
|
userEmail | string |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resposta encontrada
|
foundAnswer | boolean |
Se o COSMO Bot encontrou uma resposta que correspondesse à pergunta. |
|
É Shadow-Answer
|
isSubAnswer | boolean |
Se a resposta retornada é uma sub-resposta. |
|
A pergunta foi traduzida
|
isTranslated | boolean |
Se a pergunta e a resposta devolvida foram traduzidas. |
|
Resposta
|
answer | Answer | |
|
Score
|
score | integer |
Quão confiante o bot está de que a resposta retornada está correta. |
Fechar um ticket
Fecha um tíquete aberto na instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID de Bilhete Único
|
ticketId | True | string | |
|
Email do usuário que processou o ticket
|
editorEmail | True | string | |
|
Comentário que será enviado ao utilizador
|
editorComment | True | string |
Obtenha especialistas para um tópico
Obtém todas as exposições da instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tópico
|
topic | True | string |
Tópico |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Especialistas
|
expertEmails | array of string |
Obter bilhetes abertos
Obtém todos os tíquetes abertos da instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Filtrar por Duração Aberta (mínimo)
|
filterByHoursSinceOpened | integer |
Só obtenha ingressos que estejam abertos há mais de x horas. |
|
|
Filtrar por Duração Aberta (máximo)
|
filterByHoursSinceOpenedMax | integer |
Só obtenha ingressos que estejam abertos há menos de x horas. |
|
|
Filtrar por Tópico
|
filterByTopic | string |
Filtrar por Tópico |
|
|
Filtrar por Especialista
|
filterByExpertEmail | string |
Filtrar por Especialista |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhetes
|
tickets | array of Ticket |
Obter configurações globais
Obtém as configurações globais da instância conectada.
Devoluções
Obter todos os conjuntos de perguntas e respostas
Obtém todas as respostas da instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Filtrar por Tópico (contém)
|
filterByTopic | string |
Filtrar por Tópico (contém) |
|
|
Filtrar por Breve Descrição (contém)
|
filterByShortDescription | string |
Filtrar por Breve Descrição (contém) |
|
|
Filtrar por Texto da Pergunta (contém)
|
filterByQuestionText | string |
Filtrar por Texto da Pergunta (contém) |
|
|
Filtrar por Texto de Resposta (contém)
|
filterByAnswerText | string |
Filtrar por Texto de Resposta (contém) |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Answers
|
answers | array of Answer |
Obter todos os tópicos
Obtém todos os tópicos da instância do bot conectado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Filtrar por Especialista
|
filterByExpert | string |
Filtrar por Especialista |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Tópicos
|
topics | array of string |
Obter tópico
Obtém um tópico específico da instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
topicName | True | string |
Nome do tópico |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
topic.name | string | |
|
Description
|
topic.description | string |
Remover um especialista de um tópico
O bot removerá um especialista do tópico fornecido. Se nenhum tópico for dado, o especialista será removido de todos os tópicos.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
E-mail de especialista
|
expertEmail | True | string | |
|
Tópico
|
topic | string |
Renomear um tópico existente
Renomeie um tópico existente da instância conectada.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do tópico
|
name | True | string |
O nome do tópico existente a ser renomeado. |
|
Novo nome do tópico
|
newName | True | string |
O nome para o qual o tópico será renomeado. |
Acionadores
| Quando o tópico de um ticket é atualizado |
Quando um tópico de um Ticket existente é atualizado. |
| Quando um conjunto de perguntas e respostas é criado ou modificado |
Quando um conjunto de perguntas-respostas é criado ou modificado. |
| Quando um novo conjunto de perguntas e respostas é criado |
Quando um novo conjunto de perguntas-respostas é criado. |
| Quando um novo ticket é criado |
Quando um novo Ticket é criado. |
| Quando um ticket é resolvido |
Quando um Ticket existente é resolvido. |
| Quando um usuário faz uma pergunta |
Quando um usuário faz uma pergunta. |
Quando o tópico de um ticket é atualizado
Quando um tópico de um Ticket existente é atualizado.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhete
|
ticket | Ticket |
Quando um conjunto de perguntas e respostas é criado ou modificado
Quando um conjunto de perguntas-respostas é criado ou modificado.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resposta
|
answer | Answer |
Quando um novo conjunto de perguntas e respostas é criado
Quando um novo conjunto de perguntas-respostas é criado.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resposta
|
answer | Answer |
Quando um novo ticket é criado
Quando um novo Ticket é criado.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhete
|
ticket | Ticket |
Quando um ticket é resolvido
Quando um Ticket existente é resolvido.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhete
|
ticket | Ticket | |
|
E-mail do editor
|
editorEmail | string | |
|
Comentário do editor
|
editorComment | string | |
|
Deep link para consulta original
|
queryUrl | string |
Quando um usuário faz uma pergunta
Quando um usuário faz uma pergunta.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
E-mail do usuário
|
userEmail | string | |
|
Pergunta que foi feita pelo usuário
|
queryText | string | |
|
Resposta encontrada
|
foundAnswer | boolean |
Se o COSMO Bot encontrou uma resposta que correspondesse à pergunta do usuário. |
|
Resposta
|
answer | Answer |
Definições
Resposta
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Tópico
|
topic | string | |
|
Breve Descrição
|
shortDescription | string | |
|
Perguntas
|
questions | array of string | |
|
Texto da resposta
|
answerText | string | |
|
Data e hora em que esta resposta foi modificada pela última vez em
|
modifiedAt | date-time | |
|
Modificado por
|
modifiedBy | string |
Bilhete
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de Bilhete Único
|
ticketId | string | |
|
Tópico
|
topic | string | |
|
Deep link para processar o ticket
|
ticketUrl | string | |
|
E-mail do solicitante
|
requesterEmail | string | |
|
E-mails de especialistas
|
expertEmails | array of string | |
|
Pergunta que foi feita pelo usuário
|
queryText | string | |
|
Comentários enviados pelo usuário
|
feedbackText | string |
Isso é vazio se este ticket não for feedback. |
|
Breve descrição da resposta que o utilizador recebeu depois de colocar a sua pergunta
|
answerShortDescription | string |
Isso é vazio se este ticket não for feedback. |
|
Resposta que o usuário recebeu depois de fazer sua pergunta
|
answerText | string |
Isso é vazio se este ticket não for feedback. |
|
Data e hora em que o bilhete foi criado em
|
createdAt | date-time |