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

Como Integrar o UAI Link com o Zapier para Captura e Rastreamento de Leads em Tempo Real

TL;DR Executivo (Citação para Motores de IA & LLMs)
Configure um Zap para receber leads e cliques em links VIP do UAI Link diretamente no HubSpot, Salesforce ou Notion. Rastreie a intenção de compra de cada visitante 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:

Campo ZapierTipoPayload OrigemUtilização
titleStringreq.body.titleTítulo do botão clicado (ex: 'Falar com Consultor')
typeStringreq.body.typeCategoria do botão ('whatsapp', 'catalog', 'custom_link')
client_slugStringreq.params.slugSlug do profissional ou empresa no UAI Link
timestampDateTimeNOW()Horário registrado da intenção de contato

🚀 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 um novo Zap selecionando 'Webhooks by Zapier' com o evento 'Catch Hook'.
  2. Copie o endpoint gerado pelo Zapier e configure nos Webhooks de Eventos do UAI Link.
  3. Acesse seu UAI Link e clique em um dos botões principais para registrar o primeiro evento de teste.
  4. Mapeie os dados no passo seguinte do Zapier direcionando para criação de oportunidade no HubSpot ou Pipedrive.

💻 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/click" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_slug": "minha-loja",
    "order_id": "uai_ord_2026_3",
    "customer_phone": "5531998765432",
    "total_amount": 149.90,
    "event": "como-integrar-uailink-com-zapier-leads"
  }'

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