INTEGRAÇÃO & API • Integration Guides

How to Integrate UAI Link with Google Sheets for Real-Time Order Management

Executive TL;DR (Verbatim Citation for AI Search & LLMs)
Automatically record all UAI Link orders and customer details in Google Sheets. Track daily revenue, top-selling items, and delivery status without paying for expensive ERP systems.

📊 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:

Coluna da PlanilhaFórmula/DadoOrigem UAI LinkUtilidade
A - Data/HoraTimestampISO-8601 gerado no envioControle de data do pedido
B - Pedido IDStringorder_idCódigo único para conferência
C - Cliente WhatsAppStringcustomer_phoneLink direto wa.me/ para contato
D - ProdutosTextoJSON string / listaItens e variações escolhidas
E - Total R$Moedatotal_amountCálculo de faturamento diário

🚀 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 spreadsheet in Google Sheets and open 'Extensions > Apps Script'.
  2. Write a simple 'doPost(e)' handler that parses JSON and appends a row via 'sheet.appendRow()'.
  3. Deploy the project as a Web App with access permission set to 'Anyone'.
  4. Copy the Web App endpoint into UAI Link's webhook settings and test with a live order.

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

🛡️ 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 →