Como conectar um bot ao KWIGA

Na KWIGA, você pode conectar bots e canais de mensagens pelo Telegram, WhatsApp, Facebook Messenger, Instagram Direct e Viber.

Para conectar um bot, abra a seção de configurações correspondente na sua conta KWIGA, selecione o aplicativo de mensagens, preencha os campos obrigatórios e clique em "Salvar bot".

1. Telegram

Para conectar um bot do Telegram, insira:

• Nome — o nome do bot na KWIGA.

• Token — o token que você recebeu no Telegram do @BotFather após criar o bot.

Importante:

• Não compartilhe o token com ninguém. Ele permite gerenciar o bot.

• Se o token tiver sido comprometido, revogue-o e crie um novo pelo BotFather.

2. WhatsApp

Para conectar o WhatsApp, insira:

• Nome — o nome da conexão na KWIGA.

• Token de acesso — um token permanente de usuário do sistema.

• ID do número de telefone — o ID do número de telefone.

• ID da conta do WhatsApp Business (ID da WABA) — o ID da conta do WhatsApp Business.

• Chave secreta do aplicativo da Meta — a chave secreta do aplicativo da Meta.

Importante antes de conectar

• O número de telefone não pode permanecer vinculado ao aplicativo WhatsApp ou WhatsApp Business. Desvincule-o antes de conectar, seguindo as instruções de integração.

• Se o número for usado com outro provedor, verifique os requisitos para a transferência do número e a verificação em duas etapas.

• O aplicativo da Meta deve estar no modo Live e incluir um link para uma política de privacidade.

• Até que a Meta conclua a verificação da empresa, a interface da KWIGA mostra um limite de no máximo 250 novos clientes por dia para o envio de mensagens. Antes da publicação, confirme se esse limite ainda está em vigor e a que exatamente se aplica.

• Após o encerramento da janela de 24 horas desde a última mensagem do cliente, você só pode enviar modelos de mensagem aprovados pela Meta.

• Para entrar em contato com um cliente pela primeira vez, você deve seguir as regras do WhatsApp sobre o consentimento do destinatário para receber mensagens.

Observe também que a Meta define as tarifas das mensagens e pode impor restrições com base no status e na qualidade da conta.

3. Facebook Messenger

Para conectar o Facebook Messenger, insira:

• Nome — o nome da conexão na KWIGA.

• Token de acesso à Página — o token de acesso à Página do Facebook.

• ID da Página — ID da Página do Facebook.

• App Secret do aplicativo Meta — chave secreta do aplicativo Meta.

Importante antes de conectar

• O aplicativo Meta deve estar no modo Live e incluir um link para a política de privacidade.

• Você pode responder a um cliente com uma mensagem normal em até 24 horas após a última mensagem dele.

• Após esse período, as regras da Meta restringem as mensagens normais. Opções especiais de envio de mensagens só estão disponíveis se os requisitos da Meta forem atendidos.

• A integração exige as permissões adequadas do aplicativo e acesso à Página do Facebook.

4. Instagram Direct

Para conectar o Instagram Direct, informe:

• Nome — nome da conexão no KWIGA.

• Token de acesso do Instagram (de longa duração) — token de acesso.

• ID do usuário do Instagram — ID da conta profissional do Instagram.

• Instagram App Secret do aplicativo Meta — chave secreta do aplicativo Meta.

Importante antes de conectar

• A integração exige uma conta profissional do Instagram — Business ou Creator. Contas pessoais não são compatíveis com esse tipo de integração por API.

• O aplicativo Meta deve estar no modo Live e incluir um link para a política de privacidade.

• Você pode responder a um cliente com uma mensagem normal em até 24 horas após a última mensagem dele.

• A possibilidade de iniciar uma conversa, enviar uma mensagem ou continuar conversando depende das regras da API de mensagens do Instagram.

• A integração exige que o aplicativo tenha as permissões de mensagens necessárias.

5. Viber

Para conectar o Viber, informe:

• Nome — nome do bot no KWIGA.

• Token do bot do Viber — token obtido no Painel de Administração do Viber.

Importante antes de conectar

• A criação de um chatbot exige cadastro e aprovação conforme os termos comerciais atuais da Rakuten Viber.

• Segundo o modelo comercial atual do Viber, a taxa de serviço padrão para um novo bot é de €115 por mês. Mensagens iniciadas pelo bot que forem entregues geram cobranças adicionais. Confirme o custo final com o Viber antes de conectar.

• Nesse modelo, as mensagens enviadas durante uma sessão ativa de 24 horas não são cobradas individualmente.

• Uma sessão começa quando um assinante envia uma mensagem ao bot ou responde a uma mensagem iniciada pelo bot.

• Mensagens enviadas fora de uma sessão ativa estão sujeitas aos termos comerciais do Viber.

Configuração do bot no KWIGA

Depois de conectar um bot ao KWIGA, você pode configurar seu funcionamento, mensagens automáticas, comandos, botões e outras opções de interação com os assinantes.

As configurações disponíveis dependem do aplicativo de mensagens conectado.

Caixa de entrada

Configure como as conversas recebidas são gerenciadas e o horário de funcionamento do bot.

• Atribuição automática de conversas — atribua automaticamente as conversas aos membros da equipe em rodízio.

• Horário de funcionamento — defina o fuso horário e o horário de funcionamento.

• Resposta automática fora do horário de funcionamento — envie mensagens automaticamente aos inscritos que entrarem em contato com o bot fora do horário de funcionamento.

Mensagens

Configure as mensagens automáticas que o bot envia em diferentes situações.

Dependendo dos recursos disponíveis, você pode configurar uma mensagem de boas-vindas para quem entra em contato pela primeira vez, respostas a perguntas frequentes e mensagens sobre o acesso a grupos fechados.

Comandos

Aqui você pode criar comandos para o bot e configurar as respostas que os inscritos recebem ao digitá-los.

Os comandos aparecem no menu do bot e ajudam os usuários a encontrar informações ou iniciar uma ação rapidamente. Por exemplo, você pode criar comandos como "Ajuda", "Meus cursos", "Contatos" ou "Suporte".

Para cada comando, você pode definir o nome e a resposta do bot. Para interações mais complexas — como fazer várias perguntas aos usuários, coletar informações ou executar ações —, você pode vincular o comando a uma automação.

Também estão disponíveis comandos do sistema, incluindo //help, //menu, //stop, //unsubscribe e //subscribe, que executam as ações padrão do bot.

Botões

Configure botões que os inscritos podem usar para interagir com o bot.

Dependendo dos recursos disponíveis, você pode configurar um teclado abaixo do campo de entrada e botões abaixo das mensagens.

Links

Aqui você pode criar links individuais para o bot com identificação da origem, para acompanhar de onde vêm os novos inscritos.

Por exemplo, se você compartilhar o link do bot no seu site, no Instagram e em anúncios, crie um link para cada origem e dê a ele um nome correspondente: "Site", "Instagram", "Anúncios do Facebook" etc.

Para criar um link:

1. Digite o nome da origem.

2. Clique em "Criar link".

3. Copie o link gerado ou baixe o código QR.

4. Compartilhe-o no local apropriado.

Quando alguém acessa o link, abre o bot e clica em "Iniciar", a KWIGA registra a origem. O número de novos inscritos de cada link aparece nas configurações do link e na seção de análises "De onde vieram os inscritos".

Apenas novos inscritos são contabilizados: se alguém já interagiu com o bot, acessar outro link posteriormente não será contabilizado.

Diagnóstico

Verifique a conexão entre o bot e a KWIGA, consulte o status e use as ferramentas de diagnóstico disponíveis.

As ferramentas disponíveis dependem da integração.