Migração de URLs – Blip | Blip Help

Índice:

Como fazer a migração dos bots?

Após realizar a criação da Visão de Contrato, é necessário migrar os bots existentes para dentro deste novo perfil. Da mesma forma que os novos bots devem ser criados todos dentro desta visão.

Para realizar a migração dos bots já existentes, basta seguir os passos abaixo:

Acesse o Portal Blip, na seleção de contratos, localizada no canto superior esquerdo, selecione a opção relacionada ao usuário onde os bots ainda se encontram.

No exemplo da imagem abaixo, ele se encontra com o nome “Sustentacão” (referente ao login no Portal) e estará associado a “portal.blip.ai”. Geralmente essa opção já é selecionada por padrão quando o Portal é acessado através do link “portal.blip.ai”.

Após selecionar a opção correta, você terá a visão de todos os seus bots associados, como pode ser visto na imagem abaixo:

Para mover os bots para dentro do contrato, clique no botão “Mover chatbots”. A seguinte página será exibida:

No ícone “Mover chatbots”, clique na opção “Selecionar contrato” e escolha o novo contrato para qual deseja migrar os chatbots, conforme a imagem:

5. Com o contrato selecionado, escolha, à direita, os chatbots que deseja migrar.

Importante: A migração só será bem sucedida se os bots forem migrados junto aos seus respectivos roteadores. Por isso, é de suma importância que a pessoa responsável pela migração tenha conhecimento das associações de bots e possua permissão de administrador tanto nos bots quanto nos routers atrelados.

Dica! Se a lista de bots a serem movidos for muito grande, envie parcialmente para evitar erros no processo. Recomendamos que a migração seja de, no máximo, 10 chatbots por vez e que não ultrapasse a quantidade de 200 usuários únicos por vez. Ao tentar migrar mais de 10 bots de uma vez, o sistema mostra uma mensagem de erro de tentativa, portanto, para realizar o processo com sucesso, o limite precisa ser respeitado.

Haverá casos em que bots com um cadeado aparecerão na lista. Se isso acontecer, quer dizer que você não é o administrador do bot. No entanto, para realizar a migração, é preciso estar logado com o perfil do administrador. O cadeado aparecerá conforme indicado na imagem:

6. Com os chatbots selecionados, clique em “Confirmar”. Uma nova tela aparecerá solicitando a confirmação da operação. Para seguir, digite o texto solicitado nessa tela na caixa de texto e clique em “Confirmar”.

Importante: Conforme pode ser notado no texto exibido nesta tela, uma vez movido o bot para o contrato, essa operação não pode mais ser desfeita. Então tenha certeza de que selecionou os bots corretos e que realmente deseja efetuar esta operação.

7. Após essa etapa, uma nova mensagem é exibida confirmando a migração dos chatbots.

Caso você tenha outros chatbots para mover, selecione a opção “Continuar migrando” e repita os passos 3 a 7.

Quando tiver movido todos os bots necessários, selecione a opção “Acessar [nome do seu contrato]” e você será redirecionado para o contrato, onde poderá ver os chatbots associados a ele.

Note que, ao executar a etapa anterior, você foi redirecionado de “portal.blip.ai” para uma nova url no modelo “[identificador do seu contrato].blip.ai”.

É por meio dessa nova url que serão exibidos os chatbots associados ao contrato. Mas o acesso via “portal.blip.ai” continua funcionando perfeitamente, sendo apenas necessário selecionar o contrato no canto superior esquerdo, caso necessário, como explicado anteriormente no item 1 desta seção.

Ativação da Visão de Contrato e alterações de URLs importantes

Como parte do processo de ativação da Visão de Contrato na plataforma Blip, serão disponibilizadas algumas novas URLs para a sua operação. Entenda mais sobre esta mudança acompanhando os tópicos a seguir.

Mudança das URLs do Blip Desk e Portal

A URL que os atendentes acessam o Blip Desk e o Portal será alterada e todos os atendentes precisarão acessar obrigatoriamente o novo endereço.

URL antiga do Portal: https://portal.blip.ai
URL nova do Portal: https://idcontrato.blip.ai
URL antiga: https://desk.blip.ai
URL nova: https://idcontrato.desk.blip.ai

As URLs antigas não serão desativadas, porém, deverão ser evitadas. Caso persistam só acessos na URL antiga do Blip Desk, poderá haver problemas de performance no Blip Desk.

Como tratativa para este risco, é necessário listar quais os principais domínios de e-mail dos operadores e informar a Blip. Então, será ativado um aviso no Blip Desk para que o operador em questão seja redirecionado.
Para isto, o CM/CSM responsável irá fornecer um relatório com os acessos indevidos para o cliente comunicar a operação.

Mudança das URLs do Blip Chat - App e site

Caso você utilize o Blip Chat para disponibilizar o canal conversacional em aplicativo e/ou site, será necessário ajustar o script de instalação (encontrando em canais > Blip Chat > Instalação) para considerar a nova URL.

URL antiga: https://chat.blip.ai
URL nova: https://idcontrato.chat.blip.ai

Após a migração de contrato e cluster, o Blip Chat deverá ter seu widget atualizado com a configuração de URL correta. Caso isto não ocorra, poderá ocorrer problema de performance neste canal, além do atendimento ser impactado.

A alteração da API Key é transparente, não precisa ser atualizada.

Mudança das URLs das APIs Blip

Caso você utilize o Blip Chat para disponibilizar o canal conversacional em aplicativo e/ou site, será necessário ajustar o script de instalação para considerar a nova URL.

API	URL ANTIGA	URL NOVA
API HTTP BLIP	msging.net	idcontrato.http.msging.net
API TCP BLIP	tcp.msging.net	idcontrato.tcp.msging.net
API WS BLIP	ws.msging.net	idcontrato.ws.msging.net

Caso os endpoints não sejam alterados em aplicações que os consomem, sua performance e funcionamento podem ser impactados, portanto, é fundamental atentar-se às mudanças.

Clientes API HTTP

Alterar a URL para onde são feitas as chamadas HTTP. Em todo local, que é feita alguma requisição para a API da Blip, é necessário ser atualizada para o endpoint novo. Os endpoints estarão disponíveis nesta página e deverão ser copiados e aplicados nos locais onde já estão sendo utilizados.

Clientes API TCP

Atualizar o Host Name utilizado pelo SDK C# da plataforma. Caso o endpoint TCP esteja sendo utilizado em alguma outra rotina, alterar para a URL nova.

Clientes API WS

Atualizar o Host Name utilizado pelo SDK JS da plataforma. Caso o endpoint de WS esteja sendo utilizado em alguma rotina, alterar para a URL nova.

Mudança das URLs do Messenger

Caso você utilize o Messenger como canal, será necessário acessar o painel de administração de aplicação no Facebook e alterar as URLs, como no exemplo:

Mudança das URLs do WhatsApp (Contêiner)

Caso você utilize o WhatsApp, será necessário alterar as URLs nos contêineres do canal. Caso Blip possua acesso aos containers, nós mesmos realizaremos as alterações, mas, caso o contêiner esteja em outro ambiente, iremos apoiá-lo na realização da mudança.

URL nova: idcontrato-wa.gw.msging.net

Reativação dos bots — pós-migração de cluster

Republicação dos bots Builder

Após a mudança de cluster, para finalizar o processo, será necessário republicar todos os bots em produção para ficarem online novamente.

Acesso ao builder de todos os bots migrados (após migrar o cluster).

Reativação dos bots HTTP

Para clientes que utilizem o bot em protocolo HTTP, será necessário desativar e ativar novamente este canal.

Acessível em: Bot > Configurações > Informações de Conexão.

Reativação dos bots SDK

Para clientes que utilizem o bot em formato SDK, será necessário desativar e ativar novamente este canal.
Acessível em: Bot > Configurações > Informações de Conexão.

A Blip está se desenvolvendo cada vez mais, sempre buscando oferecer novas possibilidades para o seu negócio. Com essa nova Visão de Contrato, a sua empresa terá mais controle sobre os dados dos seus Contatos Inteligentes, acesso a informações relevantes e conseguirá acompanhar mais de perto o desempenho de todos os seus chatbots!

Vamos, juntos, realizar este processo e obter ainda mais eficiência operacional para os seus Contatos Inteligentes. Durante todo o processo, conte conosco!

Caso tenha dúvidas sobre o processo, envie um e-mail para csm@blip.ai que os nossos Customer Success Managers estarão disponíveis para esclarecê-las para você.

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃