Partilhar via

Conectar um bot ao Twilio (SMS)

  • Artigo

APLICA-SE A: SDK v4

Você pode configurar seu bot para se comunicar com as pessoas usando a plataforma de comunicação em nuvem Twilio (SMS). Este artigo descreve como configurar um bot para se comunicar usando o Twilio criando um aplicativo TwiML e conectando o bot no portal do Azure.

Pré-requisitos

  • Uma conta do Azure. Se ainda não tiver uma, crie uma conta gratuita antes de começar.
  • Um bot existente publicado no Azure.

Criar um aplicativo TwiML

  1. Se você não tiver uma conta Twilio, crie uma nova conta. Se você já tem uma conta Twilio, continue para a próxima etapa.
  2. Siga as instruções para criar um aplicativo TwiML.

    • Introduza um Nome Amigável para a sua aplicação TwiML.

    • Em Configuração de voz, deixe o URL de solicitação vazio

    • Em Configuração de Mensagens, defina o URL de Solicitação:

      • Para um bot global, digite https://sms.botframework.com/api/sms.
      • Para um bot regional, insira o seguinte url de acordo com a região selecionada:
      País/Região URL do Pedido
      Europa https://europe.sms.botframework.com/api/sms
      Índia https://india.sms.botframework.com/api/sms

Selecionar ou adicionar um número de telefone

Siga as instruções para adicionar um chamador verificado através da Consola. Você pode ignorar isso se já tiver um identificador de chamadas verificado.

Depois de terminar, você verá seu número verificado em IDs de chamador verificados.

Especificar o aplicativo TwiML a ser usado para voz e mensagens

Depois de adicionar um ID de chamador verificado, configure a configuração do seu número para usar o aplicativo TwiML que você criou.

  1. Selecione Números ativos em Gerenciar números > de telefone. Selecione o número e vá para Configurar.
  2. Em Voz & Fax e Mensagens, defina Configurar com como *TwiML App. Em seguida, defina TwiML APP para o aplicativo TwiML que você criou anteriormente. Depois de terminar, selecione Salvar.
  3. Selecione Números ativos novamente. Você verá que a Configuração Ativa de Voz e Mensagens está definida para seu aplicativo TwiML.

Reúna credenciais do Twilio

  1. Voltar à página inicial do Twilio Console

  2. Em Informações da conta, você verá o SID da conta e o token de autenticação no painel do projeto, mostrado abaixo. Copie e salve esses valores para etapas posteriores.

    Gather app credentials from Twilio Console

Insira as credenciais do Twilio no portal do Azure

Agora que você tem os valores necessários do Twilio, conecte seu bot ao Twilio no portal do Azure.

  1. Em uma janela ou guia separada, vá para o portal do Azure.

  2. Selecione o bot que você deseja conectar ao Twilio.

  3. Em Configurações, selecione Canais e, em seguida, selecione o ícone Twilio (SMS) na lista de Canais Disponíveis.

  4. Insira o número de telefone, o ID da conta e o token de autenticação que você salvou anteriormente. Depois de terminar, selecione Aplicar.

    Enter Twilio credentials in Azure

Seu bot agora está configurado com sucesso para se comunicar com os usuários do Twilio.

Teste seu bot no Twilio

Para testar se seu bot está conectado ao Twilio corretamente, envie uma mensagem SMS para seu número Twilio. Quando o bot recebe a mensagem, ele envia uma mensagem de volta para você, ecoando o texto da sua mensagem.

Informações adicionais

Para saber mais sobre como desenvolver para Twilio, consulte a documentação do Twilio SMS.

Conectar um bot ao Twilio usando o adaptador Twilio

Além de usar o canal disponível do Serviço de Bot do Azure AI para conectar seu bot ao Twilio, os repositórios da Comunidade do Bot Builder definem um adaptador de canal personalizado para o Twilio.