Search docs

Search the TryOnCloud API docs

Plataformas

Webhooks para qualquer CRM

Envie os eventos de leads para o HubSpot, o Zoho, o Zapier, o Make ou o seu servidor.

Os exemplos de código, os pontos de extremidade e os códigos de erro são os mesmos em todas as línguas.

Envie leads de experimentação da aplicação TryOnCloud para o Shopify para qualquer URL: HubSpot, Zoho, Mailchimp, Brevo, ActiveCampaign, Salesforce, Zapier, Make, n8n ou o seu próprio servidor.

Nota: Esta página trata dos webhooks de leads da aplicação Shopify. Para saber mais sobre os webhooks da API para programadores quando uma experiência de vestida assíncrona ou um lote é concluído, consulte Tarefas assíncronas, lotes e webhooks.

Ligar

  1. Abra a aplicação TryOnCloud no painel de administração do Shopify.
  2. Vá a Leads > Integrações e clique em Ligar na linha do Webhook.
  3. Cole o URL do seu ponto final https e copie o segredo de assinatura.

Evento

O TryOnCloud envia um pedido POST com um corpo em JSON quando um cliente deixa o seu endereço de e-mail após uma experiência de prova:

json
{
  "event": "lead_captured",
  "shop": "yourstore.myshopify.com",
  "created_at": "2026-11-14T10:30:00.000Z",
  "data": {
    "email": "shopper@example.com",
    "customer_id": null,
    "product_id": "8812345678901",
    "product_title": "Floral Wrap Dress",
    "result_url": "https://www.tryoncloud.com/api/result/...",
    "product_url": "https://yourstore.com/products/floral-wrap-dress",
    "tagged_shopify": true
  }
}

Cabeçalhos

TítuloSignificado
x-tryoncloud-eventlead_captured
x-tryoncloud-shopO domínio da sua loja
x-tryoncloud-delivery-idÚnico por entrega. Utilize-o para ignorar duplicados
x-tryoncloud-timestampSegundos Unix no momento do envio
x-tryoncloud-signature-v2sha256= + HMAC-SHA256 de <timestamp>.<raw body> com o seu segredo. Verifique este aqui
x-tryoncloud-signaturesha256= + HMAC-SHA256 apenas do corpo do pedido em formato bruto. Continua a ser enviado para que as integrações existentes continuem a funcionar

Verificar a assinatura

Verifique sempre antes de confiar nos dados. Utilize o corpo da solicitação em bruto, e não o JSON resserializado. Verifique o x-tryoncloud-signature-v2: este assina também o carimbo de data/hora, pelo que pode rejeitar entregas com mais de 5 minutos e uma solicitação capturada não pode ser reproduzida posteriormente. Cada nova tentativa é assinada novamente com o seu próprio carimbo de data/hora.

js
import crypto from "node:crypto"

function verify(rawBody, headers, secret) {
  const ts = headers["x-tryoncloud-timestamp"]
  const sig = headers["x-tryoncloud-signature-v2"]
  if (typeof ts !== "string" || typeof sig !== "string") return false
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false // too old: possible replay
  const expected = "sha256=" + crypto.createHmac("sha256", secret).update(`${ts}.${rawBody}`, "utf8").digest("hex")
  const a = Buffer.from(expected)
  const b = Buffer.from(sig)
  return a.length === b.length && crypto.timingSafeEqual(a, b)
}
python
import hmac, hashlib, time

def verify(raw_body: bytes, headers, secret: str) -> bool:
    ts = headers.get("x-tryoncloud-timestamp")
    sig = headers.get("x-tryoncloud-signature-v2")
    if not ts or not sig or not ts.isdigit():
        return False
    if abs(time.time() - int(ts)) > 300:  # too old: possible replay
        return False
    expected = "sha256=" + hmac.new(secret.encode(), ts.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, sig)

Entrega

  • O seu ponto final deve ser https e deve responder com um código 2xx no prazo de 8 segundos.
  • As entregas que falharam são repetidas após 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas e 24 horas.
  • As entregas podem ser recebidas mais do que uma vez. Elimine as duplicatas com base no x-tryoncloud-delivery-id.
  • Os redirecionamentos não são seguidos.