Como Integrar o UAI Link ao Make (Integromat) para Notificações Imediatas de Vendas
📊 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:
| Variável Make | Tipo | Exemplo | Finalidade |
|---|---|---|---|
order.id | String | uai_ord_98721 | Chave primária do pedido no webhook |
order.client_slug | String | adega-premium | Slug canônico do lojista |
order.items[] | Collection | [{name: 'Vinho Tinto', qty: 2}] | Coleção de itens adquiridos |
order.total | Number | 189.90 | Total do pedido para relatórios financeiros |
customer.whatsapp | String | 5511999998888 | Contato do comprador para follow-up |
🚀 Passo a Passo Numerado de Implementação
Siga o fluxo operacional homologado para garantir estabilidade, segurança e latência mínima de resposta:
- No painel do Make, inicie um novo cenário e selecione o módulo 'Custom Webhook'.
- Copie a URL de webhook gerada pelo Make e cole nas configurações de automação do UAI Link.
- Execute um pedido simulado na sua página pública para que o Make determine a tipagem do payload automaticamente.
- Conecte os módulos do Google Sheets (Add a Row) e Telegram Bot (Send a Text Message) para notificar a equipe de logística.
💻 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_2",
"customer_phone": "5531998765432",
"total_amount": 149.90,
"event": "integrar-uailink-make-integromat-notificacoes"
}'
🛡️ 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.