Referência Operacional de API

Referência de API

Tudo o que você precisa para integrar o DoesItClick ao seu stack de marketing. Use nossos endpoints REST para automatizar simulações e extrair inteligência de personas.

Base URLs

Runtime no browser: mesma origem em `/api/...`

Host direto da API: `https://api.doesitclick.ai/api/v1`

Host do Chat v2: `https://api.doesitclick.ai/api/v2`

POST

/simulations

Inicia um novo teste de mensagem contra as personas selecionadas. Esta é uma operação assíncrona. Você deve consultar o endpoint GET ou usar Webhooks para receber os eventos de conclusão.

Parâmetros do Body

projectIduuidObrigatório

Projeto alvo da simulação.

namestringObrigatório

Rótulo interno desta execução.

copySnapshotobjectObrigatório

Conteúdo de marketing que será testado.

personaIdsstring[]Obrigatório

Uma ou mais personas incluídas na execução.

scenariosstring[]

`landing_page`, `pricing_page` ou `email_sequence`.

modestring

`fast` ou `robust`, dependendo do nível de sinal necessário.

goalstring

Exemplos: `trial`, `demo`, `purchase`, `newsletter`, `brand_awareness`.

Exemplo de Request

{
  "projectId": "uuid",
  "name": "Landing Test A",
  "copySnapshot": {
    "landingPage": {
      "headline": "Stop drop-off before your trial CTA",
      "subheadline": "See which objections block intent before launch.",
      "bodyCopy": "DoesItClick helps teams test message clarity, trust, and objection patterns with synthetic personas.",
      "cta": "Start trial"
    }
  },
  "personaIds": ["uuid"],
  "scenarios": ["landing_page"],
  "mode": "fast",
  "goal": "trial",
  "source": "api"
}

Response (201)

{
  "simulation": {
    "id": "sim_98213",
    "status": "pending",
    "createdAt": "2026-02-10T..."
  }
}

Escopo desta página

Esta página é intencionalmente uma referência prática inicial. Use-a para entender o formato do contrato em produção e depois valide o comportamento exato dos endpoints em staging antes de automatizar fluxos de produção.