Central de ajudaIntegrações

Para: Administradores

Entenda o que a API pode fazer.

Saiba o que uma chave de gerenciamento e uma chave central podem fazer, por que cada chave funciona como um Assistente Virtual e onde encontrar a lista completa de especificações técnicas.

Neste artigo2 seções

A API permite que seu próprio software, como um sistema de gerenciamento de casos, funcione em conjunto com o seu hub, sem que ninguém precise usar as telas do sistema. Essa API é chamada por meio de uma chave da APIChave Um token secreto, criado em Integração, que permite que seu próprio software use a API do hub.. Existem dois tipos de chaves: uma chave para o funcionamento do painel administrativo, relacionada a casos e pessoas; e outra chave para o funcionamento dentro dos próprios casos.

Como funciona

Duas chaves, duas APIs. Cada tipo de chave corresponde a um endereço específico. Em seguida, vem o ID do seu hub. Esses endereços são rejeitados pelo outro dispositivo.

ChaveEndereçoO que isso abrange
Gerencie os elementos chave.https://prd-api-manage.caseactive.com/v1/<hub id>/Casos de uso, quem está envolvido, pessoas e seus acessos, funções, etapas do processo, busca de informações e faturas para leitura. As importações estão em https://prd-api-manage.caseactive.com/v1/integration/<hub id>/.
Chave de Hubhttps://prd-api-app.caseactive.com/v1/<hub id>/Tudo o que está dentro de cada caso: postagens e comentários, arquivos, formulários, documentos eletrônicos, tarefas, faturas, eventos, notas e os detalhes do caso.

Que funções incríveis uma chave de gerenciamento pode ter! Apenas esses. Qualquer outro chamado no API do painel administrativo resultará em uma resposta 403. BotNotAllowedException.

Cada chave é o seu Assistente Virtual. Sinais importantes enquanto você está no seu centro de controle. Assistente VirtualAssistente Virtual Um membro de equipe automatizado que publica mensagens de boas-vindas, atualizações e posts de apresentação para a empresa; suas publicações exibem um selo de Assistente Virtual.. O que é postado é indicado sob o nome e o emblema da Assistente Virtual. As alterações feitas são registradas como sendo do próprio Assistente Virtual. A Assistente Virtual está presente em todos os casos, então uma chave de hub permite acesso a todos os casos no seu hub. Ela pode fazer tudo o que a função da Assistente Virtual permite; por padrão, isso é algo que o pessoal pode fazer. No entanto, um caso fechado só pode ser lido pela Assistente Virtual. Uma chave de hub não pode criar casos, adicionar ou remover pessoas, pagar faturas, ou responder a consultas.

As chaves não expiram. As informações importantes continuarão disponíveis até que um administrador as desative ou as apague. Limite o número de informações por sistema à própria endereço IPv4 público do sistema. Veja mais detalhes aqui. Restringir ou revogar uma chave de API.

As páginas técnicas. Cada API publica uma lista técnica completa de suas chamadas, sem a necessidade de login.

Gerenciar chaveChave do hub
Interativo (Swagger UI)https://prd-api-manage.caseactive.com/https://prd-api-app.caseactive.com/
Referência (ReDoc)https://prd-api-manage.caseactive.com/redochttps://prd-api-app.caseactive.com/redoc
Documento OpenAPIhttps://prd-api-manage.caseactive.com/openapi.jsonhttps://prd-api-app.caseactive.com/openapi.json

As aplicações listam todas as chamadas que realizam, incluindo muitas das quais o teclado de gestos não consegue identificar. A lista acima indica quais funções o teclado de gestos pode utilizar. Para tentar realizar uma chamada na página interativa, selecione Autorizar e cole sua chave de acesso.

Um hub bloqueado. Quando o painel de administração do seu hub é bloqueado após um pagamento falhado, uma chave de gerenciamento é rejeitada com o código 403 ManageBillingInactiveException. Uma chave de hub continua funcionando até que o portal se torne de acesso somente leitor: 14 dias após o pagamento falho, caso ainda não tenha sido pago, ou no dia em que a assinatura cancelada termina. A partir daí, a chave de hub ainda pode ser usada para realizar alterações, mas todas as mudanças são rejeitadas com o código 403 BillingReadOnlyException, até que o administrador reinicie a assinatura.

Quando usar

Use uma chave de gerenciamento para manter seu hub sincronizado com outro sistema: crie casos, adicione clientes e coloque-os nesses casos. Tire o acesso das pessoas quando elas saírem, ou carregue várias informações de uma vez, a partir de um arquivo. Use também uma chave de hub para trabalhar dentro dos casos, com seu próprio software – por exemplo, para adicionar informações quando algo muda no sistema.

Para saber sobre as mudanças que ocorrem no seu hub, e não apenas pedir por elas, utilize um webhook. Para isso, consulte Criar um webhook. Para criar uma chave, veja Criar uma chave de API.

Artigos relacionados

Criar uma chave de APICrie uma chave de gerenciamento para a API do Painel de Administração ou uma chave central para a API do portal, limite-a aos seus endereços IP e copie-a apenas uma vez.Integrações · 5 minAutenticar solicitações de API com uma chaveEnvie sua chave como um token de portador para a API do Painel de Administração para obter uma chave de gerenciamento ou para a API do portal para obter uma chave de hub, e limite-a aos seus endereços IP.IntegraçõesConfigure um webhook para a atividade do feed.Envie uma mensagem ao seu sistema sempre que uma publicação, comentário ou anexo for adicionado, alterado ou excluído do feed.Integrações · 10 minLidar com erros e códigos de status da APILeia o corpo da mensagem de erro, o que significam os códigos 400, 401, 403, 404, 500 e 503 e por que um item que sua chave não consegue ver responde ao erro 404.Integrações