O Typebot é uma plataforma completa para criação de Chatbots, Automação de Marketing e Integrações com as principais ferramentas do mercado. Vamos te ajudar a realizar a integração com a Voxuy nesse passo a passo:

Na Voxuy

Criando um Produto:

1. Visite o módulo "Produtos";

2. Clique em "Adicionar Produto";

3. Insira um nome de referência, selecione "Voxuy - Funil personalizado API" e salve;

4. Vincule esse produto a um plano, clicando em "Adicionar Plano" e dê um nome de referência;

5. No módulo "Funil personalizado API", selecione o produto criado;

6. Clique em "Nova Categoria" e crie os eventos dentro dessas categorias;

💡Uma categoria é simplesmente um método de agrupar logicamente seus eventos pra fins de organização. Nos 3 pontinhos, você pode clicar pra alterar o nome do seu grupo e também do seu evento;

7. Agora é só você criar o funil de mensagens pra esse evento do produto que acabou de criar em "+Nova Mensagem".

Agora precisamos buscar algumas informações para finalizar a integração com a Typebot.

URL para Webhook:

Pra configurar a API Voxuy com a sua integração, você vai precisar gerar um token.

1. Acesse o menu de "Configurações";

2. Clique em "Integrações";

3. Selecione a opção "API Voxuy";

4. Clique em "copiar" no campo do código "URL para Webhook".

Na Typebot

1. Acesse a Typebot e selecione o Typebot que quer integrar com a API Voxuy.

2. Procure o ícone "HTTP request" na lateral esquerda e arraste ate o momento que deseja enviar o Webhook para a Voxuy;

2. Cole o "Token" copiado na Voxuy em "Paste URL";

3. Habilite as "Configurações Avançadas" e mantenha o método "POST";

4. Em "Body", habilite o "Custom Body" e copie o código abaixo. Mas calma, vamos precisar alterar alguns dados, viu? Te explicamos logo abaixo como encontrar cada informação do Body.

{
"clientName": "{{Nome}}",
"clientEmail": "{{Email}}",
"clientPhoneNumber": "{{Numero}}",
"apiToken": "APIToken",
"planId": "planId",
"customEvent": "customEvent",
"paymentType":99,
"status": 99
}

5. Finalizadas as configurações, lembre-se de Publicar o Typebot!

Variáveis do Webhook

No campo de Nome, Email e Numero, o nome dessas variáveis tem que estar idênticos aos criados por você, na Tipebot, tudo bem?

APIToken

Pra pegar essa informação na voxuy, basta seguir os passos abaixo.

1. Acesse o menu de "Configurações";

2. Clique em "Integrações";

3. Selecione a opção "API Voxuy";

4. Clique em "copiar" no campo do código "Token API";

5. Cole o código no campo "APIToken".

💡 Se o campo "Token API" estiver vazio, clique no botão "Gerar Novo Token".

PlanID

Acesse o módulo "Produtos" e selecione o produto criado no início da integração da Typebot;
Procure pelo plano → clique nos 3 pontos → copie o código do plano;
Cole o código no campo "planId";

CustomEvent:

Em "Funil personalizado API", selecione o produto da Typebot;
Selecione o evento desejado e copie a "ID" ;
Copie o código ID;
Cole o código no campo customEvent.

Agora você tem todas as informações necessárias pra preencher o corpo do requerimento, pode realizar um teste de forma real, na Typebot. 🚀