Atualização de bots de mensagens para usar conexões de API seguras para chamadas da API

A partir de 31 de maio de 2023, você só poderá autenticar chamadas da REST API de um bot de mensagens usando conexões de API. Um bot de mensagens pode fazer chamadas da REST API usando a etapa Fazer chamada de API.

Antes do lançamento das conexões de API, os administradores podiam autenticar chamadas da REST API de um bot de mensagens passando credenciais nos cabeçalhos de solicitação. As conexões de API são uma maneira mais segura e conveniente de armazenar essas credenciais.

Este artigo orienta você pelo processo de atualização dos seus bots de mensagens para usar conexões de API. Este artigo contém os tópicos a seguir:

• Cabeçalhos de autenticação não permitidos
• Atualização da etapa Fazer chamada de API para usar conexões

Cabeçalhos de autenticação não permitidos

Após 31 de maio de 2023, as etapas de Fazer chamada de API que incluem cabeçalhos relacionados à autenticação falharão automaticamente. Eles incluem os cabeçalhos a seguir:

• authorization
• x-api-key
• x-api-token

Se uma etapa Fazer chamada de API falhar, a conversa segue a ramificação Falha na chamada da API da etapa.

Atualização da etapa Fazer chamada de API para usar conexões

Para evitar interrupções, crie conexões de API para armazenar quaisquer credenciais de API usadas por seus bots de mensagens. Em seguida, atualize as etapas Fazer chamada de API em cada resposta do bot para usar conexões de API para autenticação.

Como atualizar uma etapa Fazer chamada de API para usar uma conexão de API

1. Se ainda não existir uma conexão de API para a credencial, crie uma na Central de administração. Consulte Criação de conexões da API para o Criador de fluxos.

   Você pode usar a mesma conexão de API em vários bots e nas etapas Fazer chamada de API.

2. Na aba Respostas da página de edição do bot, clique em Editar para acessar o Criador de fluxos para a resposta.
3. No Criador de fluxos, clique na etapa Fazer chamada de API.
4. Na etapa, use a lista suspensa Autenticação para selecionar a conexão de API relacionada.

   

5. Em Cabeçalhos, apague todos os cabeçalhos relacionados à autenticação.

   

6. Para testar a chamada da API usando as credenciais da conexão de API, clique em Fazer chamada de API.
7. Clique em Concluído no canto superior direito do Criador de fluxos.
8. Publique o bot para implantar as alterações.