Data contracts & safe integrations.
Build a tenant-safe evidence layer before connecting a model. Current OAuth, signed webhooks, minimized data, explicit consent and separate read/write authority replace the earlier “one spine, every agent writes” design.
This is not copy-paste production code. Platform endpoints, versions, scopes, pricing and policies change. Verify the official documentation on the implementation date and obtain qualified security, privacy and legal review. Use development stores/accounts and synthetic fixtures; do not test writes on a live campaign, customer or order.
1. Separate four planes
2. A minimal schema—not a customer data lake
Store only what the defined decision needs. Avoid raw webhook bodies and full conversation transcripts by default. Keep contact data out of model context and embeddings. Tokenize identifiers where possible, encrypt sensitive fields, restrict decryption to a narrowly authorized service, and enforce tenant policy server-side on every query.
3. Platform integration review
Salla
Salla's current Merchant API uses OAuth 2.0, scoped merchant authorization, the https://api.salla.dev/admin/v2 base, expiring access tokens and refresh handling. Subscribe only to necessary webhooks; follow the official verify → acknowledge → queue → process → idempotently process pattern. Never accept a webhook without its documented sender-verification control.
Official Salla get-started guide · OAuth authorization · Webhook security
Zid
The old lesson incorrectly described a static API key. Zid documents a server-side OAuth 2.0 authorization-code flow and store-scoped manager token headers. Keep client secrets and tokens server-side in approved secret storage, request minimum scopes, handle expiry/revocation, and verify the current webhook mechanism for the subscribed event.
Shopify
Pin a supported Admin GraphQL API version (the reviewed lesson uses 2026-07) and plan upgrades before its support window closes. Use the authorization flow appropriate to the app; client credentials are only for apps and stores in the same Shopify organization. Request protected customer data only when needed and approved. Fulfillment status is not universal proof that COD cash was collected—model payment, fulfillment, delivery and reconciliation as separate facts.
API versioning · Authentication and authorization · Protected customer data
Meta Marketing API and Ad Library
Pin the current Graph API version (reviewed here as v26.0), start with a dedicated read identity, and place write scopes on a separate executor only after app review and pilot approval. Do not assume a token never expires; design rotation, revocation and incident response. Use the public Ad Library as discovery material only—visibility and longevity do not prove spend, targeting, conversion or profitability. Do not replace an official interface with browser scraping unless current terms and counsel explicitly permit the exact use.
TikTok advertising and Creative Center
Verify the current Business/Marketing API product, app review, scopes, endpoints and rate limits in TikTok's official developer materials. Creative Center is an inspiration and trend-discovery surface, not proof of a competitor's business result. Respect usage terms and do not infer causal performance from ranking or visibility.
WhatsApp Business messaging
Verify the current Cloud API, pricing, customer-service window, template, opt-in and messaging rules; the dollar figures and approval times in the earlier lesson were retired. Validate webhook authenticity exactly as documented, deduplicate message IDs, minimize transcripts, honor opt-out and deletion, and limit replies to approved facts. Payments, refunds, credit, safety, complaints and ambiguity require a trained human.
4. Security and privacy acceptance criteria
5. Test without touching production
A connected API is not a production-ready workflow. Do not add real customer data or write authority until the evidence package, threat model, privacy review, platform review, owner approval, monitoring, incident response and rollback test are complete.