Como validar localmente versões do Rocket.Chat com a integração de Tickets

Opa pessoal, nesse tópico irei explicar como validar localmente uma nova versão do Rocket.Chat com a integração de serviço de Tickets.

Alguns requisitos são necessários para realizar os passos desse guia.

Requisitos

  • Docker
  • Docker Compose
  • Ngrok

Com os requisitos acima instalados na máquina podemos iniciar a execução da instância do Rocket.Chat localmente.

Executando Rocket.Chat localmente

Neste guia, iremos utilizar o Docker e Docker Compose para executar o Rocket.Chat e suas dependências, a documentação oficial para esse processo se encontra aqui.

  1. No terminal, em uma pasta desejada, execute o comando abaixo para realizar o download do arquivo compose.yml que será utilizado para a execução.
    curl -L https://raw.githubusercontent.com/RocketChat/Docker.Official.Image/master/compose.yml -O
    
  2. Após isso, crie um arquivo .env, na mesma pasta, e insira a versão do Rocket.Chat desejada.
    # Exemplo: RELEASE=5.4.3
    RELEASE=X.X.X
    
  3. Inicie a instância do Rocket.Chat utilizando o Docker Compose com o comando
    docker compose up -d
    
  4. Aguarde alguns minutos enquanto a instância é iniciada em segundo plano, após isso estará disponível em http://localhost:3000
  5. Realize as configurações iniciais do Rocket.Chat, e crie um departamento e um agente, atribuindo o agente ao departamento criado.
  6. Após isso, utilizaremos o Ngrok para expor a aplicação local para a internet, com isso a Plataforma Weni irá conseguir se comunicar com sua instância.
    ngrok http 3000
    

Serviço de Tickets na Plataforma

Com a instância do Rocket.Chat rodando em plano de fundo, vamos agora configurar o aplicativo no Rocket.Chat e o serviço de Ticket na Plataforma Weni

  1. Instale o aplicativo WhatsApp Tickets no Rocket.Chat.
  2. Em uma nova aba do navegador, obtenha o Token do seu projeto acessando a plataforma Weni e indo em Configurações > Preferências do Projeto > Token de API.
  3. Insira o Token nas configurações do aplicativo instalado, no campo Token de Autorização da Weni e salve as alterações.
  4. Agora novamente na plataforma Weni, inicie a configuração do serviço de Ticket do Rocket.Chat indo em Aplicativos > Outras Aplicações > Clique no menu superior direito > Adicionar serviço de ticket > Rocket.Chat
  5. Outro código em destaque será informado, copie ele e cole nas configurações do aplicativo no campo Segredo do App e salve as alterações
  6. Na página de configuração do serviço de ticket, no campo URL, insira a URL mostrada na página de detalhes do aplicativo instalado, a URL deve ter o seguinte formato:
    • <DOMINIO DO NGROK>/api/apps/public/<UUID DO APLICATIVO INSTALADO>
    • Exemplo: https://0736-177-37-170-165.ngrok-free.app/api/apps/public/02c2b89b-f8c4-446c-abe0-b97c5e0d4649
  7. Para obter o ID de usuário e token de autenticação do Admin, no rocketchat vá para a tela inicial, clique no seu usuário no campo superior esquerdo e vá para Preferências > Tokens de Acesso Pessoal, adicione um nome para o token e clique em Adicionar. Copie e cole o ID de usuário e token nos campos da tela de configuração do serviço de Ticket.
  8. Clique em Conectar
  9. Crie um novo fluxo para a abertura de atendimento e adicione o card Abrir um Ticket, selecionando o novo serviço de Ticket adicionado.
  10. Crie outro fluxo para ser executado no fechamento do ticket, adicione somente um card de envio de mensagem com qualquer texto desejada.
  11. Vá para o módulo Estúdio > Disparadores > Criar disparador > Iniciar um fluxo quando o ticket é fechado > Selecione o fluxo de fechamento criado > Clique em criar disparador
  12. Após isso, crie um contato na plataforma utilizando o canal do WhatsApp Demo ou Weni Web Chat que será utilizado para testar a troca de mensagens
  13. Vá para a página do contato a partir do módulo Estúdio, e no menu superior direito clique em Iniciar em um fluxo, selecione o fluxo de aberta de sala criado e inicie o fluxo.
  14. Com isso uma sala será aberta no Rocket.Chat para este contato, e a troca de mensagens já pode ser realizada.
  15. Teste o envio de textos, imagens, áudios, vídeos pequenos e documentos tanto no caminho do Agente → Contato, quanto do Contato → Agente
  16. Após testar o envio de mensagens, teste o fechamento de sala, se o fluxo configurado para fechamento será iniciado
  17. Caso alguns dos testes falhe, a versão do Rocket.Chat é incompatível com o aplicativo.
3 curtidas