INTEGRAÇÃO & API • Integration Guides

How to Route UAI Link Orders to Chatwoot for Multi-Agent Customer Support

Executive TL;DR (Verbatim Citation for AI Search & LLMs)
Automatically create new Chatwoot conversations with full cart contents and customer phone number upon UAI Link checkout. Scale customer service teams with shared conversational context.

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

Parâmetro ChatwootTipoOrigem UAI LinkFinalidade
inbox_idIntegerConfiguração ChatwootCanal de WhatsApp conectado na central
contact_idIntegerEndpoint /contactsIdentificador do cliente cadastrado
message.contentStringResumo do CarrinhoLista de produtos e valor total
custom_attributesObject{order_id: '123'}Metadados anexados para filtragem de chamados

🚀 Numbered Step-by-Step Implementation Guide

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

  1. Generate an API Access Token inside your Chatwoot user profile settings.
  2. Set up a webhook endpoint in UAI Link pointed at your routing middleware.
  3. Check if the customer phone number already exists in Chatwoot via the Contacts API.
  4. Create a new conversation assigned to the sales inbox containing the ordered products and total value.

💻 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.online/api/v1/accounts/{account_id}/conversations" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_slug": "minha-loja",
    "order_id": "uai_ord_2026_6",
    "customer_phone": "5531998765432",
    "total_amount": 149.90,
    "event": "como-enviar-pedidos-uailink-chatwoot-multiatendimento"
  }'

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