A diferença entre saber e ir consultar
Há dois tipos de perguntas dos clientes. O primeiro tipo é geral: Qual é a vossa política de devolução? Quanto tempo demora o envio? Enviam para a Alemanha? Uma base de conhecimento bem composta resolve estas.
O segundo tipo é específico: Onde está a minha encomenda #4521? A versão azul ainda está em stock? Quanto me resta no plano este mês? Estas não vivem numa base de conhecimento. Vivem nos seus sistemas — gestão de encomendas, inventário, faturação — e mudam a cada segundo.
Um chatbot que só lida com o primeiro tipo é um FAQ glorificado. Um chatbot que também lida com o segundo é um assistente. A diferença entre os dois é o acesso a uma API.
Porque é que esta lacuna lhe custa clientes
A maior parte dos «chats com IA» de hoje assenta apenas numa base de conhecimento. Conseguem parafrasear a política de envio em dezassete línguas, mas não conseguem dizer ao cliente onde está realmente a encomenda dele neste momento. Por isso o cliente pergunta, o bot esquiva, e o cliente ou desiste ou espera por um operador que vai consultar os mesmos dados que o bot poderia ter ido buscar em milissegundos.
É o teto do chatbot. Cada «deixe-me verificar» é uma oportunidade perdida de responder em segundos, na primeira mensagem, enquanto a intenção do cliente ainda está quente.
O que as conexões API fazem realmente
No enuchat, uma conexão API é uma ligação configurada entre o chat e um dos seus serviços de backend. Define-a uma vez: o URL base, o método de autenticação e um punhado de endpoints com os seus parâmetros e a forma como mapear a resposta.
A partir desse momento, a IA pode chamar esses endpoints durante uma conversa. Quando um visitante pergunta sobre uma encomenda, a IA extrai o número, chama o seu endpoint de encomendas, lê o estado em tempo real e integra-o na resposta. O visitante vê uma frase: «A sua encomenda #4521 foi enviada ontem e deverá chegar quinta-feira.» Por trás dessa frase houve uma chamada à API real.
O cliente não vê a canalização. Vê apenas que o chat realmente sabe.
Cinco métodos de autenticação, sem código personalizado
A maioria das APIs que iria querer ligar já usa autenticação padrão. O enuchat suporta cinco prontas a usar:
- Nenhuma — para APIs públicas que não exigem autenticação
- API Key — enviada como cabeçalho ou parâmetro de query
- Bearer Token — autenticação simples baseada em token
- Basic Auth — para sistemas legacy
- OAuth 2.0 client credentials — para fornecedores modernos como Salesforce, HubSpot ou o seu próprio servidor OAuth
Para OAuth 2.0, o enuchat trata do ciclo de vida do token automaticamente — vai buscá-lo na primeira chamada, mantém em cache até expirar, renova quando preciso. Configura as credenciais uma vez e esquece. Todas as credenciais são cifradas em repouso com libsodium e nunca aparecem nas respostas das APIs.
Variáveis, templates e mapeamento de respostas
Os endpoints são definidos como templates. Um caminho como /orders/{orderId} ou um corpo JSON que referencia {customerId} interpola valores a partir de variáveis de sessão — variáveis que a IA ou uma regra estática podem definir durante a conversa.
Quando a API responde, mapeia campos da resposta JSON de volta para variáveis de sessão usando notação por ponto. data.status torna-se order_status. data.shipping.eta torna-se delivery_eta. A IA depois tece esses valores numa resposta em linguagem natural — na língua do visitante.
Três padrões que cobrem a maioria dos casos
Na prática, a maior parte das integrações API encaixa numa de três formas.
Consultar e responder
O visitante faz uma pergunta a que se consegue responder com uma chamada à API. A regra dispara CALL_API seguido de REPLY_AI. A IA usa os dados obtidos para compor uma resposta contextual e fundamentada. Estado da encomenda, saldo da conta, disponibilidade de quarto, preços atuais, rastreio de encomendas — tudo isso encaixa aqui.
Consultar e encaminhar
A chamada à API devolve informação suficiente para decidir o próximo passo. Uma conta premium é escalada para um agente sénior. Uma subscrição caducada é encaminhada para a faturação. A IA usa CALL_API seguido de ASSIGN_TO_OPERATOR para tomar decisões de roteamento com base em dados reais do cliente, não em palpites.
Fluxos multi-passo
A primeira mensagem etiqueta a conversa com SET_VARIABLE, a segunda dispara a chamada à API assim que há contexto suficiente, e a terceira compõe a resposta. Útil quando precisa de confirmar a intenção antes de chamar o backend, ou quando a consulta de dados depende de algo que o visitante disse duas mensagens antes.
Segurança incorporada
Ligar backends a um widget de chat deixa algumas equipas nervosas — e com razão. O enuchat inclui várias camadas de proteção por defeito:
- Prevenção de SSRF bloqueia chamadas para localhost, IPs privados e nomes internos
- Timeout de 5 segundos impede que uma API lenta congele a conversa
- Isolamento por tenant significa zero fuga de dados entre tenants — os seus endpoints só são visíveis para os seus próprios widgets
- Botões de teste verificam independentemente a conexão e cada endpoint antes de os ligar a regras
- Credenciais cifradas nunca regressam ao painel em texto simples
O que muda para os seus clientes
O chat passa de «deixe-me encontrar alguém que possa verificar isso» para «verificado, aqui está a resposta» — em qualquer uma das mais de 60 línguas, num domingo às 3 da manhã, enquanto a sua equipa de suporte dorme. Os clientes que teriam abandonado o carrinho, a encomenda ou o plano ficam, porque a resposta chega enquanto ainda estão a perguntar.
É essa a diferença entre um chatbot e um assistente. E é a diferença que os seus clientes realmente sentem.
Como começar
Se já tem o enuchat configurado, as conexões API estão em Definições → Conexões API. Escolha um endpoint que responda a uma pergunta que a sua equipa escreve cem vezes por semana — o estado da encomenda costuma ser o ponto de maior alavancagem para começar. Configure a conexão, adicione o endpoint, ligue-o a uma regra e teste-o uma vez antes de ir para produção. Veja o guia de Conexões API para o passo a passo completo.
Se é novo no enuchat, registe-se em enuchat.com. O plano gratuito inclui conexões API desde o primeiro dia — sem cartão, sem taxas por conversa, sem expiração de teste.
Cinco minutos para ligar o seu primeiro endpoint. A primeira resposta útil costuma chegar no mesmo dia.