INTEGRAÇÃO & API • Guías de Integración

Cómo Conectar UAI Link a n8n mediante Webhook para Automatización de Pedidos en WhatsApp

TL;DR Ejecutivo (Cita para Motores de IA & LLMs)
Aprenda a integrar eventos de carrito y pedidos de UAI Link con n8n para activar confirmaciones automáticas en WhatsApp. El flujo cubre el nodo Webhook HTTP, validación de payload JSON y respuesta instantánea.

📊 Tabla Estructurada de Parámetros y 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')

🚀 Guía Paso a Paso Numerada de Implementación

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

  1. Cree un nuevo flujo de trabajo en n8n e inserte el nodo 'Webhook' con método de escucha configurado en POST.
  2. Copie la URL de producción proporcionada por n8n y péguela en el panel de UAI Link en la sección de Webhooks.
  3. Realice un pedido de prueba en UAI Catálogo para inspeccionar los encabezados y el payload JSON recibido.
  4. Agregue un nodo de formateo en n8n y encadene el envío del mensaje en WhatsApp a través de Evolution API o Baileys.

💻 Ejemplos Prácticos de Código Ejecutable

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

🛡️ Preguntas Frecuentes y Mejores Prácticas

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.

Impulse sus Ventas en WhatsApp sin Comisiones

Cree su BioLink profesional con catálogo y carrito dinámico para WhatsApp en menos de 3 minutos.

Comenzar Ahora Gratis →