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

Como Enviar Pedidos do UAI Link ao Chatwoot para Central de Atendimento Multiatendente

TL;DR Executivo (Citação para Motores de IA & LLMs)
Crie conversas automáticas no Chatwoot contendo os itens do carrinho e telefone do cliente assim que um pedido é gerado no UAI Link. Centralize atendentes sem perder o histórico do cliente.

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

🚀 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. Gere um token de acesso de usuário (User API Access Token) nas configurações de perfil do Chatwoot.
  2. Configure um webhook no UAI Link apontando para seu middleware ou servidor de mensageria.
  3. Ao receber o pedido, verifique se o contato já existe no Chatwoot através do número de WhatsApp.
  4. Abra uma conversa na caixa de entrada atribuída ao setor comercial com a mensagem estruturada do pedido.

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

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