Página prévia do link: completa ou mínima

PATCH /v1/onboarding-links/{id}

Programa com IA? Conecte-a à sua conta por MCP: ela revisa sua configuração, cria webhooks e modelos com sua confirmação e escreve o código. Veja como →

Antes de abrir a janela da Meta, o link de cadastro mostra uma página prévia. São duas:

full (a de sempre, mais curta). Três passos numerados —ter o telefone à mão, o número no WhatsApp Business e não em outra API, esperar a janela fechar sozinha—, o botão logo abaixo e o resto em «Mais detalhes».

minimal. Um único botão grande, «Conectar WhatsApp», e uma linha: «Abre-se a janela oficial da Meta. No final, espere ela fechar sozinha.» É para quando você já explicou tudo ao seu cliente antes de mandar o link. O botão não pode ser pulado: o navegador só deixa abrir a janela da Meta com um toque da pessoa.

Onde se escolhe. Por link, com intro em POST /v1/onboarding-links (e PATCH /v1/onboarding-links/{id} num link ativo; null = a da conta). Para todos os seus links, linkIntro em PUT /v1/branding ou no painel: Configurações › Marca › Cadastro por link → Página prévia. Vale o link; se não disser nada, a conta; senão, full.

O que medimos. GET /v1/onboarding-links/{id} traz introEffective e introClick: em qual página o seu cliente tocou «Conectar» pela primeira vez e quanto demorou desde que a página apareceu (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"))

Na Convivência, se você não mandar historyDelivery, a página ainda pergunta primeiro se quer receber o histórico: é o consentimento do seu cliente. Mande e em minimal fica só o botão.

Os avisos que aparecem só quando precisam continuam nas duas: o navegador do Facebook ou do Instagram (abrir no Chrome ou no Safari) e o de várias tentativas iguais.

Um valor que não seja full, minimal ou null dá 400 ONBOARDING_INTRO_INVALID; um link usado, vencido ou revogado não se edita (410).