Cómo Conectar UAI Link a n8n mediante Webhook para Automatización de Pedidos en WhatsApp
📊 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âmetro | Tipo | Obrigatório | Descrição Técnica |
|---|---|---|---|
client_slug | String | Sim | Identificador canônico da loja no UAI Link (ex: 'boutique-chic') |
order_id | String | Sim | Identificador UUID v4 único da transação gerado no checkout |
customer_phone | String | Sim | Telefone do comprador no padrão internacional E.164 (ex: +5531998765432) |
items | Array | Sim | Lista de itens com sku, nome, quantidade e valor unitário |
total_amount | Float | Sim | Valor total consolidado em Reais (BRL) formatado |
delivery_type | String | Não | Modalidade 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:
- Cree un nuevo flujo de trabajo en n8n e inserte el nodo 'Webhook' con método de escucha configurado en POST.
- Copie la URL de producción proporcionada por n8n y péguela en el panel de UAI Link en la sección de Webhooks.
- Realice un pedido de prueba en UAI Catálogo para inspeccionar los encabezados y el payload JSON recibido.
- 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.