As informações nesta página de ajuda são aplicáveis tanto ao Studio quanto ao Desktop Studio.
Nos seus scripts Studio, é possível se conectar a serviços web que usam padrões API SOAP ou RESTful.
Opções suportadas
O Studio suporta as seguintes maneiras de conexão a serviços web:
| Opção | Detalhes |
|---|---|
| Ação Studio REST API |
A ação
|
|
Integration Hub |
O Integration Hub é um aplicativo no CXone Mpower onde você pode configurar autenticação e solicitações API para uso no plataforma Ele também permite que você armazene dados confidenciais, como senhas ou chaves, em um formato criptografado para uso em scripts. A ação |
| Ações de API CXone MpowerStudio | O Studio possui várias ações de API que permitem que você faça chamadas para APIs CXone Mpower a partir dos seus scripts. Nem toda API CXone Mpower está disponível como uma ação, mas quando uma está disponível, você deve usá-la em vez de outro método. Você pode encontrar as ações de API na seção API na guia Estrutura no Desktop Studio e na paleta de Ações de API no Studio. |
| Ações SNIPPET |
Você pode escrever código em uma ação SNIPPET para se conectar com serviços web RESTful ou SOAP a partir do seu script. Este não é o método recomendado para se fazer chamadas REST porque pode retardar o atendimento de contatos. No entanto, você deve usar este método se:
|
| Integrações de fluxo de trabalho CRM | Defina as integrações de fluxo de trabalho CRM Sistemas de terceiros que gerenciam itens como contatos, informações de vendas, detalhes de suporte e históricos de casos. quando precisar fazer chamadas API para o CRM da sua organização. Isto é suportado no Agent, Agent Embedded e Agent Integrated. |
Limitações no tamanho de dados retornados
O CXone Mpower plataforma permite que as APIs REST retornem até 32 KB de dados. Esse limite evita instabilidade e interrupções do cluster. Isto é rigorosamente aplicado.
Este limite é aplicado a qualquer método de conexão com serviços web, incluindo a ação
Para reduzir o tamanho dos dados retornados:
- Filtre os dados na resposta da API. Por exemplo, se estiver usando a API de relatórios NICE para obter contatos, você pode filtrar os resultados pela startDate e endDate do contato. Esta chamada de API também permite retornar e limitar uma contagem máxima de itens. Consulte a documentação para que a API que está chamando determine qual filtro você pode usar.
- Atualize a solicitação da API para retornar apenas os dados de que precisa. Por exemplo, se estiver usando a API de relatórios NICE para obter contatos, você pode usar os campos contactId ou agentId para retornar apenas dados relevantes. Consulte a documentação para que a API que está chamando determine quais limites de dados você pode usar.
Se você não puder fazer nenhuma das opções anteriores, crie um middleware.
Código de erro -1
O código de erro -1 é um código interno usado para identificar que um erro foi encontrado com uma chamada de API. Mais especificamente, este código indica que esta é uma situação onde um código de status HTTP não será retornado ou onde o código é retornado mas não pode ser passado ao script.
A descrição de status que acompanha o código de erro -1 pode ajudá-lo(a) a determinar o problema. As descrições de status que podem acompanhar este código são:
- A solicitação foi abortada: tempo limite da operação esgotado. A solicitação pode ou não ter sido processada. Validação deve ocorrer antes da definição de um loop em resposta a um código de status -1. Pode ser necessário alterar a configuração de tempo limite na chamada usando a propriedade
-
Primitivo JSON inválido. O analisador de JSON ficou confuso com a resposta. A resposta pode ter incluído caracteres inválidos ou não estava em JSON. Com frequência, este erro ocorre quando a resposta é enviada em HTML. Você pode testar a resposta no depurador snippet. O artigo da base de conhecimento Resposta API REST não é JSON ou XML válido
pode ajudá-lo(a). -
Dados na raiz são inválidos. O analisador de XML ficou confuso com a resposta. A resposta pode ter incluído caracteres inválidos ou não estava em XML. Com frequência, este erro ocorre quando a resposta é enviada em HTML. O artigo da base de conhecimento Resposta API REST não é JSON ou XML válido
pode ajudá-lo(a). -
'doctype’ é um token inesperado. O token esperado é 'DOCTYPE'. Consulte Dados na raiz são inválidos nesta lista.
-
A tag inicial 'br’ na linha x posição x não corresponde à tag final de 'corpo'. Consulte Dados na raiz são inválidos nesta lista.
-
A conexão subjacente foi encerrada: ocorreu um erro inesperado em um envio. Frequentemente, isso significa que há um problema com o handshake TLS. Ele também pode ser causado por um IP ou uma porta não sendo abertos em um firewall; pelo uso de uma versão velha e não suportada de TLS; por certificados inválidos ou vencidos; pelo uso de um endereço IP em conjunto com HTTPS; ou problemas parecidos. Solucione o problema desta resposta com os registros de firewall do servidor de recepção.
-
A conexão subjacente foi encerrada: não foi possível estabelecer uma relação de confiança para o canal seguro SSL/TLS. Consulte A conexão subjacente foi encerrada: ocorreu um erro inesperado em um envio nesta lista.
-
A solicitação foi abortada: não foi possível criar um canal seguro SSL/TLS. Consulte A conexão subjacente foi encerrada: ocorreu um erro inesperado em um envio nesta lista.
-
Resposta grande demais. (> 32 KB). A resposta contém mais de 32 KB de dados. Quando isto ocorre, a resposta é descartada pois o sistema não tem como armazenar mais de 32 KB em uma variável. A resposta deve ser alterada ou filtrada para reduzir a quantidade de dados retornados.