Modos de integração: server-side (API) vs client-side (ads.js)

Modificado em Seg, 17 Ago na (o) 11:06 PM

Toda a lógica pesada — a chamada ao LLM, a detecção de intenção, a correspondência com o catálogo, os tokens de clique, os rate limits — roda do lado da Indoleads. Seu app apenas nos passa a conversa e renderiza o card.


um turno da conversa
Usuário → [seu app] → HTTPS → [Indoleads AI Ads API] → LLM
             ↑                            │
             └──────── reply + ad (card) ─┘

clique no card (domínio da Indoleads, não o seu)
Usuário → GET /c/{token} → 302 → link de rastreamento da rede → anunciante
Modo A — server-side (recomendado)Modo B — client-side
ComoSeu backend chama POST /api/chat, recebe JSON e renderiza o card na sua UINosso ads.js é carregado na página; as chamadas partem do navegador via IndoleadsAds.chat() / renderAd()
ChaveFica no seu servidor, nos secretsChave pública por domínio; domínios na whitelist
ControleTotal — você decide quando/como exibirMenor — mas é o mais rápido de lançar
CSPconnect-src domínio da API, img-src CDNs dos merchants+ script-src domínio do ads.js
Ideal paraProdutos com backend/pipeline de LLM própriosSites estáticos, widgets, pilotos rápidos

Em ambos os modos a resposta é o mesmo objeto — reply (sempre exiba) + ad (objeto ou null) + intent — veja Contrato da API. Em ambos os modos o clique deve passar somente pelo nosso link /c/{token}.

Requisitos de servidor para o Modo A: qualquer linguagem com HTTP+JSON de saída, UTF-8, HTTPS 443 de saída, TLS 1.2+ — veja Requisitos.

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos
A verificação do CAPTCHA é obrigatória.

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo