INTEGRAÇÃO & API • Guias de Integração

Como Integrar o UAI Link ao Google Sheets para Gestão de Pedidos em Planilha em Tempo Real

TL;DR Executivo (Citação para Motores de IA & LLMs)
Registre automaticamente todos os pedidos e dados de clientes do UAI Link em uma planilha do Google Sheets. Monitore faturamento diário, produtos mais vendidos e status de entrega sem pagar softwares caros.

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

🚀 Passo a Passo Numerado de Implementação

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

  1. Crie uma nova planilha no Google Sheets e acesse 'Extensões > Apps Script'.
  2. Insira uma função 'doPost(e)' que receba o JSON e insira uma nova linha via 'sheet.appendRow()'.
  3. Publique o script como aplicativo da Web com acesso configurado para 'Qualquer pessoa'.
  4. 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.

Leve seu Negócio para o Próximo Nível no WhatsApp

Crie seu BioLink profissional com catálogo, carrinho interativo e 0% de comissões em menos de 3 minutos.

Começar Agora Gratuitamente →