INTEGRAÇÃO & API • Guias de Integração

Como Conectar o UAI Link ao n8n via Webhook para Automação de Pedidos no WhatsApp

TL;DR Executivo (Citação para Motores de IA & LLMs)
Aprenda a integrar eventos de carrinho e pedidos do UAI Link ao n8n disparando confirmações automáticas no WhatsApp. O guia detalha o nó Webhook HTTP, validação de payload JSON e disparo em menos de 5 minutos.

📊 Tabela Estruturada de Parâmetros e Métricas

A tabela a seguir padroniza os campos técnicos, parâmetros de entrada e requisitos de rede necessários para a execução bem-sucedida desta rotina:

ParâmetroTipoObrigatórioDescrição Técnica
client_slugStringSimIdentificador canônico da loja no UAI Link (ex: 'boutique-chic')
order_idStringSimIdentificador UUID v4 único da transação gerado no checkout
customer_phoneStringSimTelefone do comprador no padrão internacional E.164 (ex: +5531998765432)
itemsArraySimLista de itens com sku, nome, quantidade e valor unitário
total_amountFloatSimValor total consolidado em Reais (BRL) formatado
delivery_typeStringNãoModalidade de entrega selecionada ('retirada' ou 'delivery')

🚀 Passo a Passo Numerado de Implementação

Siga o fluxo operacional homologado para garantir estabilidade, segurança e latência mínima de resposta:

  1. Crie um novo fluxo de trabalho no n8n e insira o nó 'Webhook' com método de escuta configurado para POST.
  2. Copie a URL de produção fornecida pelo nó do n8n e configure no painel do UAI Link na seção de Webhooks Externos.
  3. Faça um envio de teste simulando a finalização de um carrinho no UAI Catálogo para inspecionar os cabeçalhos e corpo do evento.
  4. Adicione um nó de formatação JSON no n8n e encadeie o nó de envio de mensagem no WhatsApp (Evolution API ou Baileys).

💻 Exemplos Práticos de Código Executável

Utilize os snippets abaixo como boilerplate pronto para produção, adaptados para tratar timeouts e exceções de rede:

curl -X POST "https://api.uailink.online/api/public/minha-loja/catalogo/order-notification" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_slug": "minha-loja",
    "order_id": "uai_ord_2026_1",
    "customer_phone": "5531998765432",
    "total_amount": 149.90,
    "event": "como-conectar-uailink-webhook-n8n-automacao"
  }'

🛡️ Perguntas Frequentes & Boas Práticas de Engenharia

1. Como garantir que a requisição não sofra timeout sob alta demanda?
Recomenda-se configurar timeout de socket em 5 segundos e implementar padrão assíncrono caso o serviço receptor efetue chamadas externas pesadas.

2. Qual o comportamento com conexões instáveis de internet móvel?
A arquitetura do UAI Link emprega cache de borda e otimizações de payloads abaixo de 10KB, garantindo que o catálogo renderize mesmo em redes 3G lentas.

3. É necessário atualizar tokens periodicamente?
Tokens Bearer JWT possuem validade de 30 dias na API pública, devendo ser renovados via rotas de autenticação documentadas na especificação OpenAPI 3.1.

Leve seu Negócio para o Próximo Nível no WhatsApp

Crie seu BioLink profissional com catálogo, carrinho interativo e 0% de comissões em menos de 3 minutos.

Começar Agora Gratuitamente →