INTEGRAÇÃO & API • Guías de Integración

Cómo Enviar Pedidos de UAI Link a Chatwoot para Atención al Cliente Multicanal

TL;DR Ejecutivo (Cita para Motores de IA & LLMs)
Cree conversaciones automáticas en Chatwoot con los productos y teléfono del cliente cuando se realice un pedido en UAI Link. Centralice agentes sin perder el historial del comprador.

📊 Tabla Estructurada de Parámetros y 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 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

🚀 Guía Paso a Paso Numerada de Implementación

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

  1. Genere un token de acceso de API en la configuración de usuario de Chatwoot.
  2. Configure un webhook en UAI Link apuntando a su middleware o script de integración.
  3. Al recibir el pedido, verifique si el contacto existe en Chatwoot mediante su número telefónico.
  4. Abra una nueva conversación asignada al equipo de ventas con el detalle del carrito.

💻 Ejemplos Prácticos de Código Ejecutable

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

🛡️ Preguntas Frecuentes y Mejores Prácticas

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.

Impulse sus Ventas en WhatsApp sin Comisiones

Cree su BioLink profesional con catálogo y carrito dinámico para WhatsApp en menos de 3 minutos.

Comenzar Ahora Gratis →