Integração da API SHAZAN.AI com Typebot

Introdução

A API SHAZAN.AI pode ser integrada ao Typebot para processar mensagens dentro de um fluxo de chatbot interativo. Esta documentação explica como configurar essa integração para que o Typebot envie mensagens ao SHAZAN.AI e exiba as respostas adequadamente.

Requisitos

• Conta ativa no Typebot

• Chave de API e ID do agente no SHAZAN.AI

• Endpoint da API: https://api.shazan.ai/webhook/shazan-api

Passo a Passo para Integrar com o Typebot

1. Criar um Novo Fluxo no Typebot

1. Acesse o Typebot e crie um novo bot ou edite um existente.

2. Adicione um bloco de entrada de texto para capturar a mensagem do usuário.

2. Configurar a Requisição Webhook

1. No Typebot, adicione um bloco de Requisição HTTP (Webhook).

2. Configure a requisição com os seguintes detalhes:

   • Método: POST

   • URL: https://api.shazan.ai/webhook/shazan-api

   • Cabeçalhos:

     • Content-Type: application/json

   • Corpo da Requisição:

{
    "origin": "chat-widget",
    "name": "{{name}}",
    "phone": "{{phone}}",
    "message": "{{input}}",
    "roomid": "{{roomid}}",
    "agid": "17379xxx837660x6xxx748887514546200"
}

3. Mapear a Resposta da API

1. No Typebot, capture a resposta do SHAZAN.AI.

2. Utilize as seguintes variáveis para exibir informações ao usuário:

   • {{response}} → Exibir a resposta do SHAZAN.AI ao usuário.

   • {{visit}} → Verificar se houve um agendamento de visita.

   • {{human}} → Verificar se a interação deve ser transferida para um humano.

   • {{roomid}} → Armazenar para manter a conversa na mesma sala.

4. Adicionar Bloco de Resposta

1. Adicione um bloco de Mensagem de Texto para exibir a resposta do agente SHAZAN.AI.

2. Insira {{response}} no campo de mensagem para exibir a resposta dinâmica.

Exemplo de Resposta da API

{
    "response": "Tudo bem, sim! 😊 E você? Sobre o que você gostaria de conversar? Algum interesse em nossos espaços para eventos ou estúdios?",
    "visit_date": "",
    "visit": false,
    "human": false,
    "phone": "",
    "email": "",
    "roomid": "shazan-yay5ccc0i4h",
    "messageid": "1c5cxe663r734pm"
}

Considerações Finais

Essa integração permite automatizar interações com usuários dentro do Typebot utilizando a inteligência artificial do SHAZAN.AI. Para mais informações sobre customização e autenticação, consulte a documentação oficial ou entre em contato com o suporte SHAZAN.AI.