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.
Ligar
- Abra a aplicação TryOnCloud no painel de administração do Shopify.
- Vá a Leads > Integrações e clique em Ligar na linha do Webhook.
- Cole o URL do seu ponto final
httpse 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:
{
"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ítulo | Significado |
|---|---|
x-tryoncloud-event | lead_captured |
x-tryoncloud-shop | O domínio da sua loja |
x-tryoncloud-delivery-id | Único por entrega. Utilize-o para ignorar duplicados |
x-tryoncloud-timestamp | Segundos Unix no momento do envio |
x-tryoncloud-signature-v2 | sha256= + HMAC-SHA256 de <timestamp>.<raw body> com o seu segredo. Verifique este aqui |
x-tryoncloud-signature | sha256= + 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.
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)
}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
httpse deve responder com um código2xxno 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.