Página previa del enlace: completa o mínima

PATCH /v1/onboarding-links/{id}

¿Programás con IA? Conectala a tu cuenta por MCP: revisa tu configuración, crea webhooks y plantillas con tu confirmación y te escribe el código. Ver cómo →

Antes de abrir la ventana de Meta, el enlace de alta muestra una página previa. Hay dos:

full (la de siempre, más corta). Tres pasos con número —tener el teléfono a mano, el número en WhatsApp Business y no en otra API, esperar a que la ventana se cierre sola—, el botón justo debajo y el resto en «Más detalles».

minimal. Un solo botón grande, «Conectar WhatsApp», y una línea: «Se abre la ventana oficial de Meta. Al final, esperá a que se cierre sola.» Es para cuando ya le explicaste todo a tu cliente antes de mandarle el enlace. El botón no se puede saltear: el navegador sólo deja abrir la ventana de Meta con un clic de la persona.

Dónde se elige. Por enlace, con intro en POST /v1/onboarding-links (y PATCH /v1/onboarding-links/{id} en un enlace vivo; null = la de la cuenta). Para todos tus enlaces, linkIntro en PUT /v1/branding o en el panel: Configuración › Marca › Alta por enlace → Página previa. Gana el enlace; si no dice nada, la cuenta; si tampoco, full.

Lo que medimos. GET /v1/onboarding-links/{id} trae introEffective y introClick: con qué página tocó «Conectar» tu cliente por primera vez y cuánto tardó desde que se dibujó la página (timeToClickMs).

# 1) per link: the page before Meta's window is just one button and one line
curl -X POST https://api.waiaconnect.com/v1/onboarding-links \
  -H "Authorization: Bearer wc_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"externalId": "pharmacy-42", "intro": "minimal", "historyDelivery": false}'

# 2) change it on a live link (null = the account's)
curl -X PATCH https://api.waiaconnect.com/v1/onboarding-links/onb_… \
  -H "Authorization: Bearer wc_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"intro": "full"}'

# 3) or for every link of the account that does not say it
curl -X PUT https://api.waiaconnect.com/v1/branding \
  -H "Authorization: Bearer wc_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkIntro": "minimal"}'

# 4) how long your customer took to tap «Connect»
curl https://api.waiaconnect.com/v1/onboarding-links/onb_… -H "Authorization: Bearer wc_live_YOUR_API_KEY"
# → { "link": { "intro": null, "introEffective": "minimal",
#       "introClick": { "mode": "minimal", "timeToClickMs": 4200, "at": "…" }, … } }

const H = { "Authorization": "Bearer wc_live_YOUR_API_KEY", "Content-Type": "application/json" };

// per link
const link = await (await fetch("https://api.waiaconnect.com/v1/onboarding-links", {
  method: "POST", headers: H,
  body: JSON.stringify({ externalId: "pharmacy-42", intro: "minimal", historyDelivery: false })
})).json();

// or the account default (a link that sets "intro" wins)
await fetch("https://api.waiaconnect.com/v1/branding", { method: "PUT", headers: H, body: JSON.stringify({ linkIntro: "minimal" }) });

// later: how long it took to tap «Connect»
const { link: view } = await (await fetch(`https://api.waiaconnect.com/v1/onboarding-links/${link.publicId}`, { headers: H })).json();
console.log(view.introEffective, view.introClick?.timeToClickMs);

<?php
$h = ["Authorization: Bearer wc_live_YOUR_API_KEY", "Content-Type: application/json"];
$ch = curl_init("https://api.waiaconnect.com/v1/onboarding-links");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => $h,
  CURLOPT_POSTFIELDS => json_encode(["externalId" => "pharmacy-42", "intro" => "minimal", "historyDelivery" => false]),
]);
$link = json_decode(curl_exec($ch), true);
echo $link["url"];

import requests
H = {"Authorization": "Bearer wc_live_YOUR_API_KEY"}

# per link
link = requests.post("https://api.waiaconnect.com/v1/onboarding-links", headers=H,
                     json={"externalId": "pharmacy-42", "intro": "minimal", "historyDelivery": False}).json()

# or the account default (a link that sets "intro" wins)
requests.put("https://api.waiaconnect.com/v1/branding", headers=H, json={"linkIntro": "minimal"})

# later: how long it took to tap «Connect»
view = requests.get(f"https://api.waiaconnect.com/v1/onboarding-links/{link['publicId']}", headers=H).json()["link"]
print(view["introEffective"], (view["introClick"] or {}).get("timeToClickMs"))

En Convivencia, si no mandás historyDelivery, la página igual pregunta primero si querés recibir el historial: es el consentimiento de tu cliente. Mandalo y en minimal queda sólo el botón.

Los avisos que aparecen sólo cuando hacen falta siguen en las dos: el navegador de Facebook o Instagram (abrir en Chrome o Safari) y el de varios intentos iguales.

Un valor que no sea full, minimal o null da 400 ONBOARDING_INTRO_INVALID; un enlace usado, vencido o anulado no se edita (410).