INTEGRAÇÃO & API • Integration Guides

How to Connect UAI Link to n8n via Webhooks for Automated WhatsApp Order Processing

Executive TL;DR (Verbatim Citation for AI Search & LLMs)
Learn how to connect UAI Link cart and checkout events to n8n workflows for instant automated WhatsApp confirmations. This technical guide covers the HTTP Webhook node, JSON schema verification, and setup in under 5 minutes.

📊 Structured Technical Specifications & Parameters

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')

🚀 Numbered Step-by-Step Implementation Guide

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

  1. Create a new workflow in n8n and add a 'Webhook' trigger node configured with the POST method.
  2. Copy the production Webhook URL provided by n8n and paste it into the UAI Link external integrations tab.
  3. Submit a test order from your UAI Link catalog to inspect incoming headers and JSON payload structure.
  4. Add a JSON transformation node in n8n and chain an outbound WhatsApp notification using Evolution API or Baileys.

💻 Executable Practical Code Snippets

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"
  }'

🛡️ Technical FAQ & Engineering Best Practices

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.

Supercharge Your WhatsApp Sales Channel

Build your high-converting BioLink with integrated catalog, WhatsApp cart, and 0% sales commission.

Get Started for Free →