Como Integrar o UAI Link ao Google Sheets para Gestão de Pedidos em Planilha em Tempo Real
📊 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:
| Coluna da Planilha | Fórmula/Dado | Origem UAI Link | Utilidade |
|---|---|---|---|
A - Data/Hora | Timestamp | ISO-8601 gerado no envio | Controle de data do pedido |
B - Pedido ID | String | order_id | Código único para conferência |
C - Cliente WhatsApp | String | customer_phone | Link direto wa.me/ para contato |
D - Produtos | Texto | JSON string / lista | Itens e variações escolhidas |
E - Total R$ | Moeda | total_amount | Cálculo de faturamento diário |
🚀 Passo a Passo Numerado de Implementação
Siga o fluxo operacional homologado para garantir estabilidade, segurança e latência mínima de resposta:
- Crie uma nova planilha no Google Sheets e acesse 'Extensões > Apps Script'.
- Insira uma função 'doPost(e)' que receba o JSON e insira uma nova linha via 'sheet.appendRow()'.
- Publique o script como aplicativo da Web com acesso configurado para 'Qualquer pessoa'.
- Cole a URL gerada pelo Google Apps Script no painel do UAI Link e teste um pedido real.
💻 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.onlinehttps://script.google.com/macros/s/.../exec" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"client_slug": "minha-loja",
"order_id": "uai_ord_2026_10",
"customer_phone": "5531998765432",
"total_amount": 149.90,
"event": "integrar-uailink-google-sheets-pedidos-planilha"
}'
🛡️ 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.