Migração da API setNotes e appendNotes

A API JavaScript setNotes/appendNotes do Zendesk Chat ficou indisponível quando:

A experiência do Chat integrado no Web Widget do Zendesk se tornou a padrão para os clientes Zendesk que possuem o Support e o Chat em setembro de 2019
As contas do Chat na fase 1 foram migradas para a fase 4 no final de 2019

Este artigo descreve as opções de migração disponíveis.

Informação relacionada:

Opções de migração

Há algumas opções que você pode escolher para migrar a implementação e o fluxo de trabalho do Chat da API setNotes do Widget do Chat. Recomendamos que você tome medidas proativas assim que possível para garantir uma transição sem interrupções dos fluxos de trabalho do suporte ao cliente com o Chat integrado.

As opções disponíveis requerem destreza e conhecimento de desenvolvedor e podem atender a um caso de uso específico melhor do que outras.

Na tabela a seguir apresentamos um resumo das opções disponíveis.


Opção de migração	Descrição	Pré-requisitos de implementação
Usar tags de chat	Você pode usar tags de chat do visitante em vez de usar notas. Um caso de uso comum para tags de chat do visitante é armazenar os detalhes do usuário que podem definir os segmentos de usuário mais tarde nos relatórios. Isso serve para, por exemplo, o plano do cliente, o tipo de usuário (ex.: externo, administrador) etc. Com as tags usadas, você pode pesquisar por chats ou tickets anteriores. As tags podem ser aplicadas pela API do JS ou usando um gatilho de chat.	É obrigatório ter conhecimento básico de desenvolvedor web e acesso para usar a API de JavaScript.
REST API do Chat	Existe uma REST API de visitante do Chat que permite que as notas sejam atualizadas e exibidas no Painel do Chat. A REST API pode ser chamada tanto do aplicativo do lado do servidor quanto do código JavaScript do lado do cliente. Quando as notas são atualizadas pela REST API do Chat, as atualizações são exibidas no Painel do Chat em tempo real, ou seja, enquanto o agente está conversando por chat com o visitante.	Nas duas situações acima, será necessário implementar um fluxo de OAuth para se autenticar com a API do Chat.
Aplicativo de chat público	Se você tem dados de cliente e de visitante em um prestador de serviços terceirizado, pode usar um dos aplicativos públicos de CRM: Sugar CRM SuiteCRM Shopify Chargedesk	Você precisa estar no plano pago Support + Chat.
Aplicativo de chat privado	Existe um recurso para do painel do Chat que permite instalar um aplicativo disponível da Zendesk ou criar e instalar um aplicativo privado (de acordo com o plano). Para obter informações sobre a API ou obter/atualizar informações do visitante, consulte https://developer.zendesk.com/apps/docs/chat-api/chat_sidebar#visitor-object Os aplicativos do Zendesk são excelentes para adicionar funcionalidades personalizadas ao painel do Chat, além das que o produto já oferece. A estrutura de aplicativos da Zendesk permite que clientes e desenvolvedores de aplicativos interajam com o produto Zendesk no qual o aplicativo está sendo executado. Com o uso de informações de produto ou visitante disponíveis pela API da estrutura de aplicativos do Zendesk para o Chat, é possível enriquecer o painel do Chat com informações contextuais recuperadas de um CRM de cliente ou da prestação de serviços terceirizados. Um exemplo de um aplicativo privado que enriquece o painel do Chat é o aplicativo Brain da Dollar Shave Club.	É necessário ter habilidades e conhecimentos de engenharia para criar um aplicativo de chat. Você precisaria saber como configurar em qualquer outro lugar um aplicativo da web que possa ser exibido dentro do aplicativo de chat. O aplicativo da web interage com a API JavaScript da estrutura de aplicativos do Zendesk. Ele exibe as informações relevantes para o agente do Chat na interface do usuário ao lado registro de mensagem do Chat.