Como o módulo de integração e a API do agente Aurora potencializam o atendimento e as automações empresariais

O objetivo deste artigo é explicar como o módulo de integração e a API do agente (webhook) possibilitam integrações ricas com CRMs, sistemas de pagamento, planilhas ou ferramentas de marketing como o RD Station.

O que é o módulo de integração

A documentação oficial descreve Integrações como a funcionalidade que conecta o Aurora com outras ferramentas como CRMs, sistemas de pagamento, planilhas e APIs diversas. A principal proposta desse módulo é permitir que o agente de IA utilize dados de outros sistemas para responder com contextualização ou realizar ações, e que eventos externos disparem interações com o agente.

Quando um usuário acessa o painel de integração no sistema (menu Integrações), ele encontra um fluxo guiado dividido em etapas (passos) para configurar uma chamada de API. Cada etapa ajuda a construir a integração de forma modular e sem necessidade de programação:

  1. Variáveis declaradas – o sistema detecta variáveis automaticamente a partir de expressões como #variavel ou permite criá‑las manualmente. Essas variáveis definem os dados que o agente precisa para montar a chamada. Enquanto nenhuma variável é criada, não há nada declarado.

  2. URL base (endereço da API) – define o endereço raiz do serviço externo que será chamado. O caminho e os parâmetros são configurados nos próximos passos.

  3. Path (caminho) – permite acrescentar um caminho específico, como /clientes/:id/detalhes, usando variáveis para montar IDs dinâmicos.

  4. Parâmetros (query) – parâmetros de consulta, por exemplo ?cep=#cep&formato=json, úteis para filtros, paginação ou segmentação.

  5. Cabeçalhos (headers) – cabeçalhos HTTP como Authorization: Bearer #token ou Content-Type: application/json.

  6. Corpo (body) – opcionalmente, o corpo da requisição para APIs que aceitam POST/PUT. É possível usar variáveis declaradas aqui para enviar dados dinâmicos.

  7. Valores para teste – um formulário para preencher valores reais das variáveis, simulando um cenário de chamada.

  8. Executar teste – realiza a chamada pelo backend do Aurora com os valores informados, permitindo visualizar a resposta da API e validar a integração.

  9. Analisar retorno – exibe a resposta da API para inspeção. Se a chamada retornar uma lista ou objeto JSON, o painel mostra a estrutura.

  10. Variáveis de saída – mapeia campos da resposta para variáveis internas do agente. Por exemplo, data.id da resposta pode ser associado à variável idPedido.

Após configurar e testar, a integração fica disponível para ser acionada pelo agente nas conversas. O módulo de integração dá ao atendente (ou criador de agentes) o poder de se conectar a qualquer API REST, definindo variáveis e mapeando as respostas sem escrever código. Isso permite extrair ou enviar dados a CRMs, ERPs, sistemas de pagamento, planilhas ou qualquer serviço com API.

Benefícios para o atendimento

Conectar dados externos ao agente melhora a experiência do cliente e torna o atendimento mais eficiente:

  • Respostas personalizadas – O agente pode buscar informações de pedidos, status de entrega, histórico de compras ou detalhes do cliente em um CRM e responder imediatamente com dados precisos. Como a plataforma enfatiza um atendimento rápido e personalizado, a integração fornece os insumos necessários.

  • Automação de processos – Ao mapear variáveis de saída, é possível desencadear ações automáticas em sistemas externos (ex.: abrir ticket, atualizar status, enviar e-mail). Isso reduz o trabalho manual e libera a equipe para tarefas de maior valor, contribuindo para a redução de custos.

  • Centralização do atendimento – A Aurora já oferece conexão nativa com WhatsApp e site e, através das integrações, também conecta CRMs, planilhas e ferramentas de marketing. Com isso, a empresa tem visão completa do atendimento e dados dispersos ficam reunidos em um único ambiente.

  • Suporte a múltiplos canais – O módulo de integração se integra aos fluxos de operações e às mensagens enviadas pelo WhatsApp ou Instagram. A documentação informa que a entrada de mídia (áudio, imagem e arquivo) é suportada via WhatsApp e Instagram, permitindo que integrações também recebam arquivos e encaminhem conforme necessário.

A combinação de integração com IA, chatbots e automação de fluxos transforma a experiência do cliente, aumenta as conversões e possibilita um atendimento 24/7, como destacado nos diferenciais da plataforma.

A API do agente: Webhook para interagir com a IA

Além de integrar serviços externos ao agente, a Aurora oferece uma API de agente (webhook) que permite que outros sistemas iniciem ou continuem conversas com a IA. A documentação oficial descreve um Guia Rápido de Webhook. Os principais pontos são:

Estrutura da API

  • Endpoint – As mensagens são enviadas via requisição POST para /api/agente/webhook/{agente_id}. O {agente_id} é o identificador do agente criado na plataforma.

  • Protocolo de atendimento – Cada conversa deve ser identificada por um protocolo (UUID ou ID único). O mesmo protocolo deve ser usado enquanto o atendimento estiver aberto.

  • Corpo da requisição – O payload pode incluir:

    • protocolo (obrigatório).

    • texto – mensagem enviada pelo cliente.

    • audio, imagem ou arquivo – mídias em base64 ou URL, quando suportadas pelo canal.

    • encerrar_atendimento – booleano para finalizar a conversa.

    • Metadados opcionais como nome_usuario, email e contato.

  • Resposta – O retorno do webhook inclui o agente_id, o protocolo utilizado e um objeto conteudo_recebido com a mensagem e dados do usuário. Também traz a mensagem gerada pelo agente e eventuais anexos (URLs).

  • Limites e erros – Existe um limite de caracteres (limite_caracter) e os campos de mídia só estão disponíveis para WhatsApp e Instagram. Erros comuns incluem agente não encontrado (HTTP 404) ou protocolo ausente (HTTP 400).

Utilização e benefícios

O webhook permite integrar a Aurora com qualquer sistema que precise interagir com a IA por meio de HTTP. Exemplos de uso:

  • Integração com CRM – Um CRM pode notificar o webhook quando um lead avança de etapa. O agente pode responder ao cliente com mensagens personalizadas ou iniciar novas interações.

  • Sites e aplicativos – Formulários de contato no site podem enviar dados diretamente para o agente via webhook. Isso elimina a necessidade de escrever scripts personalizados e permite reutilizar a lógica de atendimento.

  • Automação de marketing – Ferramentas de automação (ex.: RD Station ou n8n) podem usar o webhook para acionar o agente. Quando um lead preenche uma landing page, o RD Station pode disparar o webhook para que a IA envie uma mensagem de boas‑vindas ou siga um fluxo de nutrição.

Como cada mensagem enviada ao webhook é processada pelo agente Aurora, as respostas se beneficiam de todo o contexto e integração configurados na plataforma, incluindo variáveis de integração que foram mapeadas no módulo descrito anteriormente. Isso torna a API um ponto de entrada único para outras aplicações conversarem com a IA e delegarem ações automatizadas.

 

A Aurora ajuda você a atender seus clientes melhor, sem complicação.

Um ecossistema completo de IA que atende mais clientes ao mesmo tempo, reduz custos operacionais e aumenta o lucro do seu negócio.

Dê o Primeiro Passo com a IA do Aurora e Descubra o Poder da Inteligência Artificial

Comece agora, sem compromisso. Ao clicar no botão, você garante 15 dias gratuitos para testar o Aurora no seu site. Nossa equipe entrará em contato para ajudar você a transformar seu atendimento.

O Aurora é uma plataforma inteligente que simplifica a criação, treinamento e gerenciamento de agentes de IA personalizados.

Contato

* são obrigatórias

o clicar no botão solicitar contato, você concorda com nossa Política de Privacidade.