Integrari / SDK & toolsTransactional

Webhooks pentru Router by MP

Folosește Router by MP din webhook-uri externe pentru pipeline event-driven.

Raspuns scurt

Pentru pipeline-uri event-driven, primesti un webhook in serverul tau și trimiti cererea către Router by MP; un POST simplu spre /chat/completions este suficient.

Problema concreta

Sistemele care emit evenimente (CRM, ecommerce, billing) vor AI integrat fără sa stocheze chei in fiecare app sursa.

Cum o rezolva Router by MP

Endpoint custom (Cloud Functions, Edge Functions, Express) primeste webhook, valideaza signature, apoi apeleaza Router. Cheia Router este tinuta secret in mediul serverului.

Fluxuri uzuale

Receiver webhook (Vercel function, Cloudflare Worker, etc.).
Verificare signature webhook.
Apel către Router cu prompt structurat.
Returnare raspuns la sistemul sursa.

Modele recomandate

gpt-5.4-mini
gpt-5.4-nano

Disponibilitatea reala se verifica live in /models.

Control	De ce conteaza
Cheia ascunsa	App-ul sursa nu vede niciodata cheia.
Idempotenta	Endpoint-ul gestioneaza retry și dedup.
Audit	Toate apelurile au trace in cabinet.

Vercel Edge functionts

export default async function handler(req: Request) {
  const event = await req.json();
  if (!verify(event)) return new Response("invalid", { status: 401 });

  const ai = await fetch("https://api.megapromoting.com/v1/chat/completions", {
    method: "POST",
    headers: {
      "Authorization": "Bearer " + process.env.ROUTER_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "gpt-5.4-mini",
      messages: [{ role: "user", content: `Eveniment: ${JSON.stringify(event)}` }],
    }),
  });
  return new Response(await ai.text(), { status: 200 });
}

Reguli si limite

Timeout. Multe sisteme webhook au timeout 10-30s; tine apelul scurt.
Securitate. Valideaza signature inainte de apel Router.
Cost. Cap pe cheie ca sa nu cheltui in retry loops.

Integrare rapida

Foloseste endpointul https://api.megapromoting.com/v1, trimite cheia caAuthorization: Bearer <router_api_key> si verifica pagina/modelsinainte de productie.

Mai departe