Configurar o WhatsApp via Infobip

Para configurar o canal de bate-papo do WhatsApp via Infobip, um administrador da Luma precisa concluir as seguintes etapas:

1. Registre-se e crie uma conta na Infobip. Depois que a conta for criada, configure a cobrança de mensagens/transações da Infobip. Consulte Preço para obter mais detalhes.

2. Compre um novo número e configure a palavra-chave na Infobip.

3. Copie o número, a chave de API da conta, o URL base, a palavra-chave e mantenha-os em um local de fácil acesso, como o bloco de notas ou qualquer ferramenta de edição de texto.

4. Configure e ative o canal de bate-papo do WhatsApp pela Infobip na Agente virtual Luma usando o número, a chave de API da conta e o URL base gerados na conta da Infobip.

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

Etapa 1: registrar-se na Infobip

Para usar o WhatsApp via Infobip com a Agente virtual Luma, você precisa primeiramente se registrar e criar uma conta na Infobip. Para isso, siga as etapas abaixo:

1. Vá até o site da Infobip inserindo o URL https://www.infobip.com/. A página inicial da Infobip é exibida como mostrado abaixo.

   Open

   

2. Clique em Efetuar logon para criar uma conta da Infobip. Se você já tem uma conta, pule para a próxima etapa (ponto 3).
   Para obter mais detalhes sobre a criação da conta e outros detalhes de gerenciamento de conta, consulte Infobip Documentation Hub.

   1. Clique em Sign-up.

   2. Na tela de inscrição, adicione os detalhes da nova conta.

   3. Clique em Iniciar a avaliação gratuita para criar a conta.

      Open

      

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

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

   6. O link redireciona você de volta para a página de ativação da conta da Infobip https://www.infobip.com/activate. Crie um nome de usuário e uma senha para o seu logon.

   7. Depois que o logon é criado, você é redirecionado para o portal da Infobip. Conclua a verificação da conta da Infobip.
      Forneça seu número de telefone para receber o código de verificação.

   8. Adicione o código de verificação e clique em Verificar.

   9. A conta agora está verificada. Conclua a criação da conta e vá para a página inicial.

3. Se você já tem uma conta, efetue logon na Infobip usando os detalhes da sua conta e vá para a página inicial.

    

4. Uma vez conectado, a próxima etapa é adicionar créditos com base em seu plano de preços.

Etapa 2: configurar o número do remetente na Infobip

Assim que sua conta estiver pronta, a próxima etapa será configurar o número do remetente do WhatsApp para o seu bot. Esse número é usado pelos usuários finais para se conectar ao seu tenant da Luma VA. Para isso, siga as etapas abaixo:

1. Na página inicial da Infobip, role para baixo até as opções "Obter números". Você também pode encontrar a opção em Aplicativo,

2. Clique em Solicitar número.

3. Adicione as informações necessárias, como Tipo de número, Canal, etc. no formulário de solicitação e clique em Enviar solicitação.
   Observação: com base nos detalhes do formulário de solicitação, a Infobip fornece o ETA, ou seja, o tempo estimado necessário para adquirir o número e o preço que você deve pagar depois que o número for adquirido e atribuído à sua conta. Para obter mais informações, consulte Comprar números.

4. Assim que o número for atribuído à sua conta, ele começará a aparecer em Aplicativos → Números.

5. Copie o número do remetente e guarde-o em um local de fácil acesso, como o bloco de notas ou qualquer ferramenta de edição de texto.

6. A próxima etapa é adicionar uma palavra-chave para o número.
   Palavras-chave são o texto nas mensagens de entrada que são usadas para filtrar mensagens específicas recebidas em um número. Cada palavra-chave pode filtrar mensagens e executar uma ação predefinida, como encaminhar a mensagem para outro sistema, encaminhar para email, salvar a mensagem para registro em log, etc.

7. Selecione o número na grade e clique em Adicionar uma palavra-chave no painel lateral.

8. Na tela ADICIONAR PALAVRA-CHAVE, inclua a seguinte configuração para permitir que o número encaminhe as mensagens para o seu bot.

   1. Adicione uma nova palavra-chave.

   2. Defina o campo Encaminhamento como "Encaminhar para HTTP".

   3. O Método deve ser definido como POST.

   4. Em seguida, efetue logon no Criador de bot para copiar o URL da mensagem da página de configuração do WhatsApp pela Infobip para o seu bot.
      Para obter o URL da mensagem,

      1. Efetue logon no Criador de bot e vá até Configurações → Canais no menu do bot.

      2. Selecione o canal WhatsApp pela Infobip para exibir os detalhes de configuração.

      3. Copie o URL da mensagem.

   5. Adicione o URL da mensagem copiado na etapa acima (etapa d) ao campo URL.

   6. Clique em Para salvar para concluir a criação da palavra-chave.

   7. Sua conta da Infobip agora está configurada e pronta.

Etapa 3: gerar chave de API

A próxima etapa é gerar uma chave de API válida e copiar os outros detalhes necessários para configurar o WhatsApp pela Infobip como um canal de bate-papo no Agente virtual Luma.

1. Vá para a página inicial da Infobip.

2. Clique em Gerenciar chaves de API.

3. Na página Chaves de API, clique em NOVA API DE CHAVE.

4. Criar chave de API agora está aberta. Adicione os seguintes detalhes:

   1. Adicione a chave NAME.

   2. Adicione a DATA DE EXPIRAÇÃO para a chave. Ao atingir a data de expiração, a chave é desativada automaticamente. Você pode atualizar a data de expiração ou gerar novamente uma nova chave.

   3. Selecione as FUNÇÕES para a API pública. Isso fornece ao bot acesso a todas as chamadas de API.

   4. Caso queira restringir o acesso à API, adicione os endereços IP no campo ENDEREÇOS IP PERMITIDOS, SEPARADOS POR VÍRGULA.

   5. Feito isso, clique em ENVIAR para gerar a chave.

   6. A nova chave está listada na página Chave da API. Copie a chave da API e guarde as informações no bloco de notas ou na ferramenta de edição de texto com o número (como na Etapa 2 → 5)

       

5. Além da chave da API, você precisa do URL base para concluir a configuração.
   Vá para a página inicial da Infobip e copie o URL base. Guarde as informações no bloco de notas ou na ferramenta de edição de texto com a chave da API e o número (como na etapa anterior).

Etapa 4: configurar o WhatsApp via Infobip na Agente virtual Luma

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

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

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

   3. Agora, adicione o URL base, a chave da API e o número do remetente (copiado na Etapa 2 e na Etapa 3) aos respectivos campos na tela de configuração na interface do usuário do Criador de bot.

   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.

   5. Clique em Configurar para ativar o WhatsApp pela Infobip. O canal está ativado e definido como Ativo.

   6. O WhatsApp via Infobip agora está ativo e pronto para uso.

Etapa 5: convidar usuários para o WhatsApp

Depois que o canal estiver ativo e configurado, você poderá convidar usuários da sua organização para se conectarem à Agente virtual Luma por meio do WhatsApp.
Para se comunicar com a Luma VA, o usuário final deve fazer o seguinte:

1. Adicione o número do remetente (gerado na Etapa 2 → 5) à lista de contatos do WhatsApp. Você também pode escanear o código QR em https://portal.infobip.com/apps/whatsapp.

2. Assim que o número for adicionado, envie uma mensagem do WhatsApp ao número com a PALAVRA-CHAVE (criada na Etapa 2 → 8).

Quando você efetuar logon em nosso domínio de envio de teste, todas as mensagens enviadas do seu número para o remetente da Infobip serão mapeadas para a sua conta. 

O usuário agora está mapeado para sua conta da Infobip e os usuários agora podem começar a interagir com a Agente virtual Luma por meio do WhatsApp. Se o usuário 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.

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

Todas as conversas e mensagens enviadas para

Logs de conversa

Você pode exibir o log de mensagens enviadas pelos usuários à Agente virtual Luma por meio do WhatsApp pela Infobip. Os logs podem ser usados para solucionar ocorrências com as conversas do usuário.

Para exibir os logs,

1. Vá para a Página inicial → Aplicativos → WhatsApp.

2. Em WhatsApp → Exibir logs, clique em Exibir logs.

3. Na guia Registros de envio, é possível visualizar os detalhes das mensagens enviadas e recebidas por WhatsApp pela Infobip.