Skip to main content
Included with every self-managed instance. This tab is part of Whitelabel Setup.

What is this?

The Instance Config tab holds instance-wide settings that aren’t tied to a specific cron job — a fallback email sender, a currency-conversion API, message-credit billing units, and a read-only status panel written by background processes. Changes here apply without a restart. The Instance Config tab showing the four sections: Universal email fallback (SES), Currency conversion (FX rate API), Message credit billing, and Read-only instance status

What can I do here?

Universal email fallback (SES) — used when a platform has no email settings configured, or its primary provider fails:
  • Region (e.g. ap-south-1)
  • Access key ID
  • Secret access key
  • From email
  • Reply-to email
Currency conversion (FX rate API) — base URL and key used for cross-currency conversion:
  • API base URL (e.g. https://open.er-api.com/v6/latest)
  • API key
Message credit billing — credit units consumed per stored message and status update:
  • Units per stored message
  • Units per status update
  • Billable statuses (comma separated) — which WhatsApp status-update events (e.g. sent, delivered, read, failed) count toward billing.
  • Estimated updates per message
Read-only instance status — written by background processes, cannot be edited here:
  • Worker heartbeat — status, role, PID, and last-seen time of the background health worker.
  • Platform capacity records — total messages sent all-time, peak combined throughput, and when it was last sampled.
Each of the three editable sections (SES, FX rate API, message credit billing) has its own independent Save section button.

How to use it

  1. Scroll to the Universal email fallback (SES) card and fill in your AWS SES Region, Access key ID, Secret access key, From email, and Reply-to email. Click Save section on that card to save just this section. The Universal email fallback (SES) card with its fields and Save section button
  2. Scroll to the Currency conversion (FX rate API) card and enter the API base URL and API key for your exchange-rate provider. Click Save section.
  3. Scroll to the Message credit billing card and set Units per stored message, Units per status update, Billable statuses (comma separated), and Estimated updates per message. Click Save section. The Message credit billing card with its numeric fields and the billable statuses text field
  4. Review the Read-only instance status card at the bottom to confirm the worker heartbeat is recent and check platform capacity numbers — these fields aren’t editable and are for diagnostics only. The read-only Worker heartbeat and Platform capacity records panels
Last modified on September 21, 2026