Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Observe que o Twilio para WhatsApp, atualmente, é um produto em versão Beta disponibilizado pela Twilio. Verifique os detalhes desse produto Beta no site da Twilio https://www.twilio.com/docs/sms/whatsapp/api.

A Luma oferece suporte ao WhatsApp como um canal de bate-papo para as organizações, que usam o WhatsApp como um dos canais suportados para envolvimento com o usuário. A API do Twilio para WhatsApp ajuda as organizações no envio e recebimento de mensagens dos seus usuários do WhatsApp.

Para configurar o canal de bate-papo do WhatsApp, um administrador do Criador de habilidades precisa concluir as seguintes etapas:

  1. Registre-se e crie uma conta no Twilio. Depois que a conta for criada, configure a cobrança de mensagens/transações do Twilio. Para obter detalhes sobre preços e cobrança, consulte https://www.twilio.com/whatsapp/pricing/us.

  2. Crie um projeto no Twilio. Copie a SID da conta, o token de autorização, o número do remetente, o código de ativação e mantenha-os em um local de fácil acesso, como no bloco de notas ou em qualquer ferramenta de edição de texto.

  3. Configure e ative o canal de bate-papo do WhatsApp na Agente virtual Luma usando a SID da conta e o token de autorização do projeto Twilio Whatsapp.

  4. Convide os usuários para usar o canal do WhatsApp para interagir com a agente virtual.

Etapa 1: registrar-se no Twilio

Para usar o WhatsApp com a Agente virtual Luma, primeiramente, você precisa se registrar no Twilio. Para isso, siga as etapas abaixo:

  1. Acesse o site do Twilio inserindo o URL www.twilio.com. A página inicial do Twilio é exibida como mostrado abaixo.

    Image Added

  2. Crie uma conta no Twilio clicando em Inscrever-se. Para saber como se inscrever para uma conta do Twilio e obter outros detalhes do gerenciamento de contas, consulte https: //support.twilio.com/hc/en-us/sections/205104908-Account-Management.
    Se você já tem uma conta, pule para a próxima etapa (ponto 3).

    1. Na tela de inscrição, adicione os detalhes necessários e a senha.

    2. Selecione a opção Aceito a Política de privacidade do Twilio. eclique em Iniciar a avaliação gratuita para criar a conta.

      Image Added
    3. Um email será disparado para o endereço de email (adicionado na etapa acima) para verificar sua conta.

    4. Clique no link do email e confirme o seu endereço de email.

      Image Added
    5. O link redireciona você de volta para o Twilio. Para verificar o seu número de telefone, adicione o número e clique em Verificar.

      Image Added
    6. Digite o código de verificação recebido em seu telefone e clique em Enviar.

      Image Added
    7. A conta agora está verificada. Conclua a criação da contae vá para o Painel do projeto.
      Em Você escreve código, clique em Não e clique em Pular para o painel.

      Image Added
  3. Se você já tem uma conta, efetue logon no Twilio usando os detalhes da sua conta e vá para o Painel.

    Image Added

  4. Uma vez conectado, a próxima etapa é criar um projeto. Se você já tem um projeto, pule para a próxima etapa (ponto 5).

    1. No Painel do projeto, clique em Criar novo projeto.

      Image Added
    2. Adicione o nome do projeto e clique em Verificar.

      Image Added
    3. Forneça seu número de telefone e código de verificação para verificar sua conta (como no ponto 2→e). Agora pule para o Painel.

      Image Added
    4. Seu projeto está pronto.

  5. No Painel do projeto, copie os detalhes abaixo e guarde as informações no bloco de notas para serem usadas na configuração de canal na Luma. Clique no botão Copiar nos campos:

    1. SID da conta

    2. Token de autorização

      Image Added

Etapa 2: configurar o Whatsapp na Agente virtual Luma

  1. A próxima etapa é configurar e ativar o WhatsApp como um canal de bate-papo na Agente virtual Luma.

    1. Efetue logon no seu inquilino na interface do usuário do Criador de bot.

    2. Vá para Menu do bot → Configurações → Canais. Clique no bloco Twilio WhatsApp e abra as configurações.

      Image Added
    3. Agora, adicione a SID da conta e o Token de autorização (copiados na Etapa 2 → ponto 5) aos respectivos campos na tela de configuração, na interface do usuário do Criador de bot.

      Image Added
    4. Na seção Reconciliação do usuário para autenticação de canal, especifique as informações do usuário que devem ser usadas para autenticação automática e reconciliação de dados do usuário com os campos de registro da Agente virtual Luma. Como o Whatsapp usa o número de telefone do usuário para autenticação, selecione telefone em Campos do usuário e clique em Definir.

      Image Added
    5. Copie o URL da mensagem e guarde as informações em um bloco de notas para serem usadas na configuração do serviço de mensagem do Twilio em uma etapa posterior.

      Image Added
    6. Clique em Configurar para ativar o WhatsApp. O canal está ativado e definido como Ativo.

      Image Added

Etapa 3: configurar sandbox do WhatsApp

Depois que o canal for configurado na interface do usuário do Criador de bot, a próxima etapa é criar e configurar a sandbox. A sandbox do Twilio para WhatsApp ajuda você a se conectar ao seu bot.

  1. No Twilio, vá até o Painel do projeto. Clique em Todos os produtos e serviços.

    Image Added
  2. Vá para Mensagens programáveis.

    Image Added

  3. Clique em Definições → Definições da sandbox do WhatsApp.

    Image Added

  4. Uma mensagem de confirmação é exibida para ativar a sandbox. Concorde com os Termos de Serviço e clique em Confirmar.

    Image Added

  5. A página Sandbox do Twilio para WhatsApp é exibida.

    1. Na seção Configuração da sandbox, configure o URL do terminal. Isso indica o ambiente da Luma e o inquilino aos quais a sandbox deve se conectar.

    2. Copie o URL da mensagem que foi copiado/retido na etapa 2 → ponto 1(e), cole-o no campo Quando chegar uma mensagem e clique em Salvar.

    3. A sandbox está pronta.

      Image Added

Etapa 4: convidar usuários para sua sandbox

Agora que o canal está ativo e a sandbox configurada, você pode convidar usuários de sua organização para se conectarem à Agente virtual Luma por meio do WhatsApp. Para usar a sandbox do Whatsapp, o usuário final deve seguir este procedimento:

  1. Adicionar o número do remetente fornecido na seção Participantes da sandbox da lista de contatos dele.

  2. Depois que o número for adicionado, enviar uma mensagem do WhatsApp ao número com o código de ativação.

O usuário será adicionado à sandbox. Todos os usuários (números de telefone) com acesso ao bot estão disponíveis em USERID.

...

  1. Agora, os usuários podem começar a interagir com a Agente virtual Luma por meio do WhatsApp. Se o usuário conectado já estiver disponível na Agente virtual Luma (com o número de telefone usado para o WhatsApp), o usuário será autenticado automaticamente pelo sistema. Nenhum registro manual é necessário.

    Image Added

  2. Caso o usuário não esteja disponível na Agente virtual Luma, o sistema reconhecerá esses usuários como Usuários anônimos e solicitará que o usuário se registre na Agente virtual Luma.

    Image Added

Info

Pontos a serem lembrados:

  1. O número de telefone do usuário na Agente virtual Luma deve estar no mesmo formato <Código do país><número de telefone> conforme usado para instalar e configurar o WhatsApp. Se o número não estiver incorreto, o usuário não será autenticado automaticamente na Agente virtual Luma.

  2. O Whatsapp é um canal com base em texto e não oferece suporte a cartões e respostas rápidas. As respostas do bot definidas como Cartões ou Respostas rápidas aparecem como opções com números, que são usados para selecionar a opção necessária.

Preços do Twilio

Depois que sua conta do Twilio for criada, certifique-se de configurar a cobrança pelas mensagens/transações do Twilio. Existem dois tipos de mensagem -

  • Mensagem da sessão do WhatsApp

  • Mensagem de modelo do WhatsApp.

Mensagem da sessão do WhatsApp é qualquer mensagem enviada ou recebida em resposta a uma sessão iniciada pelo usuário. Uma sessão de mensagens começa quando um usuário envia uma mensagem para a Agente virtual Luma e dura 24 horas, a contar da mensagem recebida mais recentemente. Você pode esperar que os usuários enviem uma mensagem ou pode enviar uma mensagem de modelo para convidar o usuário a responder.

A mensagem de modelo do WhatsApp é iniciada pela Agente virtual Luma (acompanhamento, aprovação ou resolução). Trata-se de modelos de mensagem pré-aprovados para notificações de saída, como alertas de entrega e lembretes de compromissos. Uma mensagem de modelo do WhatsApp poderá ser usada se mais de 24 horas tiverem se passado desde a última vez que o usuário respondeu para você. Qualquer outro tipo de mensagem falhará. 

Para obter mais detalhes sobre quanto o Twilio cobra pelos diferentes tipos de mensagem, consulte https://www.twilio.com/whatsapp/pricing/us.