Hi {{contact.firstName}}, it just shipped.
',\n variables: { 'contact.firstName': 'Maria', 'order.id': '#1001' },\n replyTo: 'support@yourcompany.com',\n});\n```\n\n### Batches\n\nUp to 1000 recipients per call, each with its own variables. Per-recipient values\nwin over the shared ones:\n\n```ts\nconst res = await cognizy.email.send({\n templateId: 'tpl_123',\n variables: { 'company.name': 'Acme' }, // applies to everyone\n recipients: [\n { to: 'ana@example.com', variables: { 'contact.firstName': 'Ana' } },\n { to: 'bruno@example.com', variables: { 'contact.firstName': 'Bruno' } },\n ],\n});\n// { count: 2, items: [{ id: 'oe_1', … }, { id: 'oe_2', … }] }\n```\n\nA batch is **all-or-nothing against your quota**: if the monthly allowance plus\nwallet balance can't cover every recipient, nothing is sent and\n`EmailQuotaExhaustedError` tells you the shortfall. Partial delivery would leave\nyou unable to tell which recipients still need the message.\n\n```ts\nimport { EmailQuotaExhaustedError } from '@cognizy/sdk';\n\ntry {\n await cognizy.email.send({ recipients, templateId });\n} catch (err) {\n if (err instanceof EmailQuotaExhaustedError) {\n // { requested: 500, includedRemaining: 120, payableFromWallet: 0, shortfall: 380, … }\n await topUpWallet(err.details.shortfall! * (err.details.priceCents ?? 0));\n }\n}\n```\n\n### Delivery status\n\n```ts\nconst email = await cognizy.email.get('oe_1');\n// status: QUEUED → SENT → DELIVERED → OPENED → CLICKED, or BOUNCED / FAILED\n```\n\nStatus only ever moves forward, so a late provider event can't undo a later one.\nRather than polling, subscribe to the `email.message.status` webhook.\n\n### WhatsApp\n\nSame shape. Free-form text and media need an open 24h session window with the\nrecipient; outside it WhatsApp only accepts a template approved in your WABA:\n\n```ts\nawait cognizy.whatsapp.send({\n to: '+5511999999999',\n type: 'TEMPLATE',\n template: { name: 'order_update', language: 'pt_BR', variables: ['Maria', '#1001'] },\n});\n\nconst msg = await cognizy.whatsapp.get('om_1');\n// status: QUEUED → SENT → DELIVERED → READ, or FAILED\n```\n\nNote that Meta bills WhatsApp messages directly to the card on your WhatsApp\nBusiness account — Cognizy doesn't charge per message. Platform email is\ndifferent: it leaves through Cognizy's infrastructure, so it draws on your plan's\nmonthly allowance and then your wallet. Bringing your own SendGrid or Mailgun\naccount exempts you from both.\n\n## Errors\n\nThe SDK throws typed errors for the cases you'll want to handle:\n\n```ts\nimport {\n AuthError,\n RateLimitError,\n QuotaExceededError,\n EmailQuotaExhaustedError,\n CognizyError,\n} from '@cognizy/sdk';\n\ntry {\n await cognizy.messages.send({ conversationId, message: 'hi' });\n} catch (err) {\n if (err instanceof RateLimitError) {\n await sleep(err.retryAfterSeconds ?? 60);\n } else if (err instanceof QuotaExceededError) {\n notifyOps(`Hit ${err.used}/${err.limit} requests this month`);\n } else if (err instanceof EmailQuotaExhaustedError) {\n notifyOps(`Out of email credit — ${err.details.shortfall} couldn't be sent`);\n } else if (err instanceof AuthError) {\n rotateKey();\n } else if (err instanceof CognizyError) {\n console.error(err.status, err.code, err.message);\n }\n}\n```\n\nThe two quota errors mean different things and take different fixes:\n\n| Error | Status | Meaning | Fix |\n|---|---|---|---|\n| `QuotaExceededError` | 429 | Too many **API requests** this month | Wait, or raise the plan's request limit |\n| `EmailQuotaExhaustedError` | 400 | Out of **emails** — allowance and wallet both spent | Add wallet credit, or upgrade the plan |\n\nWaiting never clears the second one; only money does.\n\n## API reference\n\nThe full Public API is documented in Swagger UI at:\n\n```\nhttps://