Integrando o Widget de Chat Zendesk à Plataforma Discourse

Documentação Integrações
,
1

:bookmark: Este guia explica como adicionar um widget do Zendesk Chat ao seu fórum Discourse, permitindo que você ofereça suporte em tempo real aos seus usuários.

:person_raising_hand: Nível de usuário necessário: Administrador

Adicionando um widget do Zendesk Chat ao Discourse

Este guia irá guiá-lo pelo processo de integração de um widget do Zendesk Chat ao seu fórum Discourse. Este recurso permite que você ofereça suporte em tempo real aos seus usuários do fórum.

Criando uma conta Zendesk

  1. Acesse Register e preencha o formulário de registro.

Screenshot 2024-03-01 at 2.02.44 PM
Screenshot 2024-03-01 at 2.02.44 PM1920×1020 62.6 KB

  1. Siga as etapas de registro e escolha o nome da sua equipe. Este se tornará automaticamente o URL para acessar o Zendesk.

Screenshot 2024-03-01 at 2.03.57 PM
Screenshot 2024-03-01 at 2.03.57 PM1920×1081 64.3 KB

  1. Verifique seu e-mail e confirme seu endereço de e-mail, em seguida, faça login no Zendesk.

Configurando o widget do Zendesk Chat

  1. Depois que sua conta for configurada, vá para o seu Centro de Administração do Zendesk (https://your_team_name.zendesk.com/admin/home).

  2. No painel do Centro de Administração, clique em Channels (Canais) no menu à esquerda e, em seguida, selecione Messaging (Mensagens):

Screenshot 2024-03-01 at 1.49.23 PM
Screenshot 2024-03-01 at 1.49.23 PM2248×1392 289 KB

  1. Na página de Mensagens, clique no nome da sua equipe:

Screenshot 2024-03-01 at 1.50.11 PM
Screenshot 2024-03-01 at 1.50.11 PM2336×734 44.7 KB

  1. Conclua as etapas de Add Web Widget (Adicionar Widget Web):
    • Confirme o nome do canal
    • Copie o trecho de código do widget web
    • Personalize a aparência do chat (cor, posição, som, etc.)

Screenshot 2024-03-01 at 1.50.20 PM
Screenshot 2024-03-01 at 1.50.20 PM2314×1442 308 KB

Screenshot 2024-03-01 at 1.55.59 PM
Screenshot 2024-03-01 at 1.55.59 PM1232×1192 86.4 KB

Adicionando o widget do Zendesk Chat ao Discourse

  1. No painel de administração do seu Discourse, vá para Admin > Appearance (Aparência) > Themes and Components (Temas e Componentes) e mude para a aba Components (Componentes), em seguida, clique em Install (Instalar).

image
image627×695 21.4 KB

  1. Selecione Create new (Criar novo).

image
image227×251 3.4 KB

  1. Insira um nome para o componente, certifique-se de que o Tipo esteja definido como “Component”, e clique em Create (Criar).

image
image671×288 8.1 KB

  1. Escolha os temas onde deseja adicionar o novo componente e, em seguida, clique em Edit CSS/HTML.

image
image787×561 58.5 KB

  1. Navegue até a aba Common > <head>, cole seu script do Zendesk e clique em Save (Salvar).

Configurando a Política de Segurança de Conteúdo

  1. Nas configurações do seu site Discourse, pesquise por “content security policy script src”.
  2. Adicione https://static.zdassets.com/web_widget/ à lista de permissões (whitelist).

Verificando a instalação

  1. Recarregue seu site Discourse. Você deverá ver agora o ícone de chat na parte inferior do seu site, visível tanto para visitantes quanto para usuários registrados.

image

image
image359×573 8.32 KB

Finalizando a configuração do Zendesk Chat

Após adicionar o widget ao seu fórum Discourse, você precisará configurar suas configurações de chat:

  1. Volte para https://your-team-name.zendesk.com/admin/channels/messaging_and_social/channels_list

  2. Clique no nome da sua equipe para acessar as configurações do widget.

  3. Você pode personalizar vários aspectos do seu chat:

    • Style (Estilo): Ajuste a aparência do seu widget de chat para corresponder ao design do seu fórum.
    • Responses (Respostas): Configure respostas automatizadas ou mensagens prontas para consultas comuns.

:information_source: Lembre-se de testar seu widget de chat completamente após fazer qualquer alteração para garantir que ele esteja funcionando como esperado em seu fórum Discourse.

14 curtidas