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

Como Conectar o Catálogo UAI Link à Evolution API para Disparo Automático no WhatsApp

TL;DR Executivo (Citação para Motores de IA & LLMs)
Dispare mensagens transacionais de confirmação e fotos de produtos via Evolution API assim que o cliente fecha o carrinho no UAI Catálogo. Elimine respostas manuais e aumente a conversão em 40%.

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

Parâmetro EvolutionFormatoDescriçãoExemplo
numberStringTelefone de destino com código de país5531988887777
textStringMensagem Markdown com detalhes do pedido*Pedido #123 Confirmado!*
apikeyHeaderChave de autenticação da instânciaB6D711FCDE4D4FD59365...
instancePathNome da sessão conectada ao WhatsAppuailink-bot-atendimento

🚀 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. Inicie sua instância da Evolution API e leia o QR Code garantindo status 'open'.
  2. Configure um serviço Node.js intermediário ou nó n8n para escutar os pedidos do UAI Link.
  3. Formate a mensagem com a quebra de linhas e cálculo total do carrinho recebido.
  4. Dispare a chamada HTTP POST para '/message/sendText' na Evolution API entregando a confirmação ao cliente.

💻 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_4",
    "customer_phone": "5531998765432",
    "total_amount": 149.90,
    "event": "conectar-catalogo-uailink-evolution-api-whatsapp"
  }'

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