Overview · {{ ov.customer.name }}
Loading…
Your data bundle (invoices, usage and consent as CSV in one ZIP) can be made again {{ time(ov.bundle.next_at) }}.
Credit
Automatic top-up: paused on off adds {{ ov.credit.auto_topup.currency }} {{ money(ov.credit.auto_topup.config.amount) }} below {{ money(ov.credit.auto_topup.config.threshold) }}; {{ money(ov.credit.auto_topup.spent_month) }} charged this month. {{ ov.credit.auto_topup.config.pause_reason }} Manage
Buy credit
This month
Last month ({{ ov.usage.last_month }}): {{ ov.usage.last_month_total.sent.toLocaleString() }} sent, {{ ov.usage.currency }} {{ money(ov.usage.last_month_total.cost) }}. {{ ovChange() > 0 ? '+' : '' }}{{ ovChange() }}% against the same days last month.
Usage by account
| Account | Sent | Received | Cost | Last month | Quota |
|---|---|---|---|---|---|
| No accounts yet. | |||||
| {{ u.account }} {{ u.channel }} |
{{ u.month.sent.toLocaleString() }} | {{ u.month.received.toLocaleString() }} | {{ money(u.month.cost) }} | {{ u.last_month.sent.toLocaleString() }} sent · {{ money(u.last_month.cost) }} | {{ quotaText(u.quota) }} cap reachedover 80%— |
Costs in {{ ov.usage.currency }}. Volume discounts apply to your total, so each account's cost is its share of it.
Invoices
{{ inv.number }} {{ inv.currency }} {{ money(inv.amount_due != null ? inv.amount_due : inv.total) }} unpaid
sent {{ ago(inv.sent_at) }}
E-invoice
Open / print
CSV
Recently paid
{{ inv.number }} {{ inv.currency }} {{ money(inv.total) }} paid {{ time(inv.paid_at) }}
E-invoice
Open / print
CSV
Account health
| Account | Status | Last message | Uptime (30 days) |
|---|---|---|---|
| No accounts yet. | |||
| {{ a.name }} {{ a.channel }} |
{{ statusLabel(a.status) }} | {{ ago(a.last_message_at) }} | {{ a.uptime_30d.toFixed(2) }}% {{ a.incidents_30d }} outage{{ a.incidents_30d === 1 ? '' : 's' }} |
Webhooks (last 24 hours)
| API key | Deliveries | Failed | Last failure | |
|---|---|---|---|---|
| No API keys with a webhook. | ||||
| {{ k.name }} {{ k.webhook_url }} |
{{ k.total.toLocaleString() }} {{ k.counts.pending + k.counts.retrying }} waiting |
{{ k.counts.failed }} · {{ k.failure_pct }}% | {{ ago(k.last_failure.at) }} {{ k.last_failure.response_status ? 'HTTP ' + k.last_failure.response_status + ' · ' : '' }}{{ k.last_failure.error }} none |
|
Consent
| Account | Opted in | Withdrawn | Opted out | |
|---|---|---|---|---|
| {{ c.account }} | {{ c.granted }} | {{ c.withdrawn }} | {{ c.opted_out }} | Consent CSV |
Counted by each contact's latest recorded decision.
Accounts
Testing has ended, so sending is paused. {{ myCustomer.testing.reason === 'cap' ? 'All ' + myCustomer.testing.message_cap.toLocaleString() + ' messages included in testing have been sent.' : 'It ran until ' + testingDay(myCustomer.testing) + '.' }} Receiving still works. Contact us to move to production and keep sending.
You are testing until {{ testingDay(myCustomer.testing) }}, with {{ Math.max(myCustomer.testing.message_cap - (myCustomer.testing.messages_sent || 0), 0).toLocaleString() }} of {{ myCustomer.testing.message_cap.toLocaleString() }} messages left. Messages are free while testing; sending pauses when it ends. Contact us to move to production.
You have used all {{ myCustomer.account_limit }} accounts in your plan. Delete one, or ask us for more.
| Account | Status | Customer | Server | Proxy / exit IP | Last seen | |
|---|---|---|---|---|---|---|
| No accounts yet. Click a “New account” button. | ||||||
| {{ a.name }} {{ channelLabel(a) }} +{{ a.phone }} · {{ a.country }} |
{{ statusLabel(a.status) }}
working…
Code
{{ a.pair_code }}Telegram sent a login code to this number
Pair the phone running the RelayKin app
{{ phoneOf(a).charging ? '⚡' : '🔋' }} {{ phoneOf(a).battery }}%
· {{ phoneOf(a).network || 'no network' }}
·
· app {{ phoneOf(a).app_version || '?' }} · {{ ago(phoneOf(a).last_seen) }}
{{ phoneWarnings(a).join(' · ') }}
{{ a.last_error }}
|
{{ a.customer_id ? customerName(a.customer_id) : 'Yours' }} | {{ hostName(a.host_id) }} port {{ a.port }} |
{{ proxyFor(a)?.display }}
server IP
{{ a.current_ip }}
{{ proxyFor(a).country }}
{{ f }}
|
{{ ago(a.last_seen) }} |
Inbox
Not available right now: {{ chatsDown.join(', ') }}
Insights
Campaigns
Personalised messages sent slowly, one about every 15 seconds per number. Sending limits and opt-outs always apply, and the campaign waits when it reaches a limit. Message only people who agreed to hear from you: complaints are the fastest way to get a number banned.
New campaign
Sent from the phone's SIM card, slowly (about one a minute, set per account) and up to a daily limit, so the mobile network does not block the SIM. Messages wait during quiet hours and after the daily limit; none are skipped. Opt-outs (STOP) always apply.
About {{ campaignSMS.parts }} SMS part{{ campaignSMS.parts===1 ? '' : 's' }} per message, {{ campaignSMS.total }} for the list. {{ campaignSMS.chars }} characters; each part is charged by the mobile network.
The message is over 1600 characters.
{{ campaignSMS.text }}
| Campaign | Number | Status | Progress | Starts | |
|---|---|---|---|---|---|
| No campaigns yet. | |||||
| {{ c.name }} {{ c.template }} |
{{ accountName(c.account_id) }} | {{ c.status }} {{ c.reason }} |
{{ campaignDone(c) }} of {{ campaignTotal(c) }} {{ c.counts.sent||0 }} sent, {{ c.counts.skipped||0 }} skipped, {{ c.counts.failed||0 }} failed
{{ c.counts.replied||0 }} replied, {{ c.counts.opted_out||0 }} opted out · consent only
{{ v.variant }}: {{ v.sent }} sent, {{ replyRate(v) }} replied, {{ v.opted_out }} opted out |
{{ time(c.scheduled_at) }} | |
With small numbers, a difference of a few replies can be chance. Wait for at least a few dozen sends on each side.
Numbers are hidden. Show full numbers (asks you to confirm, and is logged).
Responses, within 7 days of the message
No replies or opt-outs yet.
{{ p.phone }}
replied {{ ago(p.replied_at) }} opted out {{ ago(p.opted_out_at) }}Not delivered
No skipped or failed recipients.
{{ p.phone }} {{ p.status }} {{ p.error }}Messages
Totals of messages sent, refused and received{{ financeOwner ? '' : ' on your accounts' }}. The CSV export shows contacts masked.
Every message sent, refused or received{{ isAdmin ? '' : ' on your accounts' }}. Kept for {{ (security && security.retention && security.retention.message_log_days) || 90 }} days unless the owner chooses otherwise.
| Channel | Sent | Delivered | Read | Failed | Refused | Received | Delivery rate |
|---|---|---|---|---|---|---|---|
| {{ channelLabel({ channel: c.key }) }} | {{ c.sent }} | {{ c.delivered }} | {{ c.read }} | {{ c.failed }} | {{ c.blocked }} | {{ c.received }} | {{ rate(c.delivery_rate) }} |
sent failed or refused received
| Time | Account | Channel | From | Contact | Status | Reason | |
|---|---|---|---|---|---|---|---|
| No messages in this period. | |||||||
| {{ time(m.at) }} | {{ msgAccounts[m.account_id] || accountName(m.account_id) }} | {{ channelLabel({ channel: m.channel }) }} | {{ m.direction === 'out' ? 'Sent' : 'Received' }} | {{ m.direction === 'out' ? m.source : '' }} | {{ m.contact }} |
{{ m.status === 'blocked' ? 'refused' : m.status }} · {{ m.parts }} parts | {{ m.error }} |
Usage
Plan and credit
Buy credit
Automatic top-up
When the credit falls below a level, the saved card is charged and the credit added, up to a monthly cap. Only Stripe keeps the card's details.
Paused: {{ autoView.config.pause_reason }} Update the card or buy credit, then turn it on again.
{{ autoView.reason }}
Account quotas
| Account | Use of its caps | |
|---|---|---|
| {{ q.account }} | {{ quotaText(q.use) }} | cap reachedover 80% |
Set an account's caps in its settings, under Message quota.
Online top-ups
| When | Reference | Amount | Status |
|---|---|---|---|
| {{ new Date(p.created_at).toLocaleString() }} | {{ p.number }}{{ providerName(p.provider) }} | {{ p.currency }} {{ money(p.amount) }} | {{ p.status === 'open' ? 'not paid yet' : p.status }} |
Credit history
| When | What | Amount | Balance |
|---|---|---|---|
| {{ new Date(e.at).toLocaleString() }} | {{ e.kind }} {{ e.note }}
| {{ money(e.amount) }} | {{ money(e.balance_after) }} |
Invoices
Plans and credit
| Customer | Plan | Balance | Spend this month | Avg a day | Days left |
|---|---|---|---|---|---|
| No customers yet. | |||||
| {{ r.customer }} | {{ planText(r.billing) }} | {{ r.currency }} {{ money(r.balance) }}postpaid | {{ r.currency }} {{ money(r.spend_month) }} | {{ r.currency }} {{ money(r.avg_daily) }} | {{ r.billing.payment_mode==='prepaid' ? daysText(r.days_left) : '—' }} |
Prices
| Item | Price ({{ prices.currency }}) |
|---|---|
| {{ f[1] }} | {{ prices[f[0]] === undefined || prices[f[0]] === null ? '—' : money(prices[f[0]]) }} · {{ prices.tiers[f[0]].length }} volume tiers |
{{ Object.keys(priceOverrides).length }} customer(s) have their own prices; their invoices show them.
Online payments
| Reference | Customer | Amount | Provider | Status | Opened |
|---|---|---|---|---|---|
| No online payments yet. | |||||
{{ p.number }}Prepaid credit |
{{ paymentCustomer(p) }} | {{ p.currency }} {{ money(p.amount / 100) }} | {{ providerName(p.provider) }} | {{ p.status }} | {{ new Date(p.created_at).toLocaleString() }} |
Data warehouse exports
| Day | Dataset | Status | Rows | Size |
|---|---|---|---|---|
| {{ e.day }} | {{ datasetName(e.dataset) }} | {{ e.status }} | {{ e.rows }} | {{ (e.bytes / 1024).toFixed(1) }} KB |
| Account | API key | {{ m[1] }} |
|---|---|---|
| Nothing recorded in this period. | ||
| {{ usageAccount(r.account_id) }} | {{ keyName(r.api_key_id) }} | {{ (r.totals[m[0]]||0).toLocaleString() }} |
Counted from when this screen was added. Replies from the inbox, AI and voice appear with no API key.
Agents
| Person | Replies | Chats | Median first response | Average | Ratings |
|---|---|---|---|---|---|
| {{ a.email }} | {{ a.replies }} | {{ a.chats }} | {{ duration(a.median_response_seconds) }} | {{ duration(a.avg_response_seconds) }} | {{ a.ratings ? a.avg_rating.toFixed(1) + ' / 5 (' + a.ratings + ')' : '—' }} |
{{ reportPreview.body }}
Response time runs from a customer's first unanswered message to a person's reply from the Inbox. Ratings come from chats closed with the satisfaction check on. All ratings: {{ n }}★ {{ agentStats.ratings[n]||0 }} ·
AI draft quality
Proxy pool
One per line: scheme://user:pass@host:port, host:port or host:port:user:pass. Each proxy is tested for exit IP, country and datacenter status.
| Proxy | Status | Exit IP | Country / ISP | Risk | Used by | |
|---|---|---|---|---|---|---|
| No proxies. Without a proxy an account uses its server's IP. | ||||||
| {{ p.display }} {{ p.label }} |
{{ p.status }}
{{ p.last_error }} |
{{ p.exit_ip || '—' }}{{ p.latency_ms }} ms |
{{ p.country || '—' }} {{ p.isp }} |
datacenterflagged clean | {{ p.account_id ? accountName(p.account_id) : '—' }} | |
Servers
Ubuntu server with Docker installed; the SSH user must be able to run docker. Allow ports {{ info.port_from }}–{{ info.port_to }} only from this portal's IP ({{ info.public_ip }}).
Alerts go out when disk passes 80% (critical at 90%), memory passes 90% (95%), the load stays above 2 per processor, or free memory stays low enough to leave room for 2 more accounts or fewer. The room estimate keeps 512 MB spare. It allows each account half again its highest use in the last 7 days, at least 100 MB, and 150 MB until accounts have been measured.
Memory per account last 7 days, sampled every 15 minutes
| Account | Now | Average | Highest |
|---|---|---|---|
| {{ m.name }} | {{ m.latest_mb }} MB | {{ m.avg_mb }} MB | {{ m.peak_mb }} MB |
Portal release {{ info.release || 'dev' }}. To go back to the release before, run ./release.sh --rollback in the portal folder on the main server.
Integration API keys
External systems use an API key + secret to send and receive WhatsApp messages through
{{ info.public_url || '(set PORTAL_DOMAIN)' }}/v1. Generating a key gives you the full integration details to send to the other system. Public docs: interactive API reference (Swagger UI), guide, OpenAPI.
Integration URLs
Give these to the third-party application together with an API key and secret. They contain no secrets.
The portal's public address is not set (PORTAL_DOMAIN), so these URLs are incomplete. Ask your administrator to set it.
| API base URL | {{ (info.public_url || '') + '/v1' }} | |
| MCP server (AI agents) | {{ (info.public_url || '') + '/v1/mcp' }} | |
| Interactive API reference | {{ (info.public_url || '') + '/api-docs' }} Swagger UI: read every endpoint and try it with an API key (a test key is best). | |
| Integration guide | {{ (info.public_url || '') + '/integration/guide.md' }} | |
| OpenAPI spec | {{ (info.public_url || '') + '/integration/openapi.yaml' }} |
For your developers webhook signatures and per-key details
For one key's details (accounts, webhook, limits and examples) choose More ▾ → Developer details. Secrets are shown only once, when a key is made or replaced, so send those separately and securely.
Webhooks are signed: X-RelayKin-Signature: t=<unix>,v1=<hex>, where v1 is the HMAC-SHA256 of <t>.<raw body> with the webhook signing secret. Reject anything older than 5 minutes.
const [t, v1] = header.split(',').map(p => p.split('=')[1]);
const expected = crypto.createHmac('sha256', process.env.RELAYKIN_WEBHOOK_SECRET)
.update(t + '.' + rawBody).digest('hex');
const ok = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1))
&& Math.abs(Date.now() / 1000 - Number(t)) < 300;
| Base URL | {{ info.public_url }}/v1 |
| X-API-Key | {{ newCreds.api_key }} |
| X-API-Secret | {{ newCreds.api_secret }} |
| Webhook signing secret | {{ newCreds.webhook_secret }} |
Send these details to the system or developer using this key. They include everything needed to connect, including the secrets, so use a secure channel.
{{ newCreds.integration_details }}
{{ keyForm.id ? 'Edit' : 'New' }} API key
Tick or untick accounts to add or remove them. The change applies to this key's next request, and the secret stays the same.
The key starts with kwa_test_. Numbers ending in 0001 fail after sending, 0002 are never read, 0003 are never delivered, 0004 are refused as opted out, 0005 get a network error and 0006 a rate limit. See the guide's sandbox section.
| Name | API key | Accounts | Webhook | Last used | Deliveries 24h | ||
|---|---|---|---|---|---|---|---|
| No API keys yet. | |||||||
| {{ k.name }} revoked test key |
{{ k.key_id }} |
{{ k.all_accounts ? 'All' : k.account_ids.map(accountName).join(', ') }} |
{{ k.webhook_url }}
Connected
Not reachable
Not tested yet
{{ ago(k.webhook_checked_at) }}
{{ k.webhook_error }}
{{ healthLabel(k.health) }}
{{ k.health.paused_deliveries }} waiting
polling only
{{ k.events }}
|
{{ ago(k.last_used_at) }} | {{ st }} {{ n }} |
| |
Failing webhooks when a webhook that keeps failing is paused, and how it is tried again
Each webhook gets a health score from its last hour: deliveries that succeeded, failures in a row, answer time and timeouts. Degraded and failing webhooks are reported to you and, for a customer's key, to its managers.
Failed webhook deliveries
| API key | Event | Account | Status | Attempts | Last error | When | |
|---|---|---|---|---|---|---|---|
| {{ d.key_name }} | {{ d.event }} | {{ accountName(d.account_id) }} | {{ d.status==='failed' ? 'failed' : 'retrying' }} | {{ d.attempts }} | {{ d.last_error }} | {{ ago(d.created_at) }} |
Activity & alerts
| Number | To | Status | Next try | Note | |
|---|---|---|---|---|---|
| Nothing is waiting. | |||||
| {{ accountName(m.account_id) }} | {{ m.recipient }} |
{{ m.status }} | {{ m.status==='pending' ? time(m.next_attempt_at) : '' }} | {{ m.last_error }} | |
| When | Who | What | Target | Result | IP |
|---|---|---|---|---|---|
| Nothing recorded yet. | |||||
| {{ time(e.created_at) }} | {{ e.actor }} | {{ e.action }} | {{ e.target }} |
{{ e.status<400 ? 'OK' : 'Failed' }} | {{ e.ip }} |
Passkeys
Sign in with your phone, fingerprint, face or a security key instead of the password. Passkeys stay on your device; the password keeps working as a backup.
Passkeys need the portal to run on a domain.
Security
Approvals
With two or more admins, deleting a customer or a customer's account, changing prices or a customer's limits, ending a lockdown and campaigns to more than 1,000 people wait for a second admin. Requests lapse after 24 hours.
Add a second admin to have risky changes approved by two people. Until then they go ahead, and the audit log notes there was no second admin to approve.
No requests yet.
Emergency lockdown
On since {{ ago(security.lockdown.since) }}, started by {{ security.lockdown.by }}: {{ security.lockdown.reason }}
For a suspected breach. Signs out everyone else, refuses agents and API keys, and stops campaigns, queued sends and webhooks. WhatsApp connections stay up, so nothing needs pairing again.
Status
{{ security.backup.last_error }}
Backups are on this server, so losing the server would lose them too.
Who has access
Last reviewed: {{ security.access_reviewed ? ago(security.access_reviewed) : 'never' }}. Review at least every {{ security.review_days }} days, and remove anyone who has left under Settings.
| Person | Role | Accounts | Passkeys | Last active | Last opened a chat | |
|---|---|---|---|---|---|---|
| {{ p.staff.email }} {{ customerName(p.staff.customer_id) }} | {{ p.staff.role }} | {{ p.staff.role === 'admin' ? 'All' : p.staff.role === 'manager' ? 'All of the customer\'s' : p.staff.all_accounts ? (p.staff.customer_id ? 'All of the customer\'s' : 'All') : (p.staff.account_ids || []).length }} | {{ p.passkeys }} | {{ p.last_seen ? ago(p.last_seen) : 'not signed in' }} | {{ p.last_chat_view ? ago(p.last_chat_view) : 'never' }} |
How long records are kept
Older records are deleted automatically, in days; 0 keeps them. Consent records are kept for ever unless Retention per customer below says otherwise, and opt-outs stay as long as their contact, as proof of what they asked for. Messages on WhatsApp are not affected.
Where you're signed in
Your password
{{ isAdmin ? 'Staff' : 'Your team' }}
Agents use only the Inbox of the accounts you choose. Managers run one customer's accounts, Inbox, campaigns, integrations and team, and never see servers, proxies or other customers. Admins can do everything.
Agents use only the Inbox of the accounts you choose. Managers can also add accounts, run campaigns and integrations, and manage the team.
Emailed to {{ inviteResult.email }}. You can also send this link yourself:
{{ inviteResult.note || 'It was not emailed.' }}
{{ inviteResult.link }}It works once, for 72 hours. Anyone with it can {{ inviteResult.purpose==='reset' ? 'set this person\'s password' : 'join as this person' }}, so send it only to them.
Waiting to join
Old address usage
Who still reaches the portal at its older addresses in the last 30 days, so you can retire them. The main address is {{ oldAddresses.primary }}.
Safe to remove {{ d.domain }} from PORTAL_ALIAS_DOMAINS{{ d.last_used ? ': last used ' + ago(d.last_used) : ': not used since recording started' }}.
Nothing has used it.
Customers
A customer is a company that uses the portal through its own managers. Each customer sees only its own accounts, Inbox, campaigns, API keys and team, and never your servers, proxies, security settings or other customers. Its managers can add accounts up to the limit you set; new accounts get a free proxy from your pool automatically. Move an existing account to a customer from its Manage window.
Monthly limits count every account and API key of this customer, by calendar month (UTC). At the limit, sending or AI is refused until the next month.
Lowering the limit keeps the accounts they have; it only stops new ones.
While testing they can add one number, and its messages are free. Sending pauses when testing ends or the message cap is reached; you and they are told 3 days before (or at 80% of the cap). When they are ready, use Move to production on the customer to allow more numbers and start charging.
Their first manager (optional)
The person at the customer who signs in and runs their side. You can add more users later with “Add user”.
Set up a client
Creates the customer, its manager's login, its prices and plan, a first top-up and its number in one go. Nothing is saved until you confirm on the next step, and if any part is refused, nothing is saved at all.
Their manager
Their prices
Leave a price empty to use yours (shown greyed out).
Plan and credit
Check before you create it:
- {{ l }}
{{ setupResult.customer.name }} is set up
- {{ l }}
{{ setupResult.manager.emailed ? 'The invite was emailed to ' + setupResult.manager.email + '. You can also copy the link:' : 'Send this invite link to ' + setupResult.manager.email + ' (' + setupResult.manager.note + '):' }}
The link works once, for 72 hours.
{{ c.name }} topped up {{ c.production_offer.currency }} {{ money(c.production_offer.amount) }} on {{ new Date(c.production_offer.offered_at).toLocaleDateString() }} while testing. Nothing it sends is charged until it moves to production.
Give {{ c.name }} one of your numbers. It moves to them with its chats and settings; their managers and agents can use it at once. You can take it back from the account's Manage window. They are in testing, so this will be their one free test number.
Change testing for {{ c.name }}. Testing runs to the end of the last day (UTC). A later day or a higher cap lets paused sending go on at once; an earlier day ends testing early.
Move {{ c.name }} to production. Their messages are charged from today at their prices, and they can add numbers up to the new limit. The test number stays.
Plans and credit
How each customer pays. Prepaid customers use credit as messages go out (charged once a minute); with “stop at zero”, sending and AI stop when it runs out. Days left is the balance at the last 7 days' average spend. A customer that stays below its low-credit level is reminded again every few days until it tops up, and you are told each time.
| Customer | Plan | Balance | Sent this month | Spend this month | Avg a day | Days left | |
|---|---|---|---|---|---|---|---|
| No customers yet. | |||||||
| {{ r.customer }} |
{{ planText(r.billing) }}stops at zero | {{ r.currency }} {{ money(r.balance) }}postpaid
{{ followUpText(r.follow_up) }} |
{{ channelText(r.sent_by_channel) }} | {{ r.currency }} {{ money(r.spend_month) }} | {{ r.currency }} {{ money(r.avg_daily) }} | {{ r.billing.payment_mode==='prepaid' ? daysText(r.days_left) : '—' }} | |
Invoices
One invoice a month per customer, from its usage at your prices (below). Mark an invoice sent when you send it: only then can the customer's managers see it. Open it to print or save as PDF.
| Invoice | Customer | Total | Status | |
|---|---|---|---|---|
| No customers to bill this month. | ||||
{{ inv.number }} |
{{ inv.customer }} {{ (inv.lines || []).length ? inv.lines.map(l => l.item + (l.tier ? ' (' + l.tier + ')' : '') + ' ' + l.quantity).join(' · ') : 'No charges' }} |
{{ inv.currency }} {{ money(inv.total) }}
incl. {{ inv.tax_exempt ? inv.tax_name + ' exempt' : inv.tax_name + ' ' + inv.tax_rate + '%: ' + money(inv.tax_amount) }}
at 1 {{ inv.base_currency }} = {{ inv.fx_rate }} {{ inv.currency }}
No {{ inv.fx_missing }} rate yet: shown in {{ inv.currency }}
credited {{ money(inv.credited) }} · due {{ money(inv.amount_due) }} |
{{ inv.status }}
{{ overdueText(invoiceOverdue[inv.customer_id]) }}
sending paused
{{ invoiceOverdue[inv.customer_id].stage }} online via {{ providerName(paidOnline[inv.customer_id].provider) }} |
|
Invoice currency and tax
Tax is added to every invoice's subtotal, unless a customer is exempt or has its own rate (a customer's Invoicing button). A customer can be invoiced in its own currency: amounts are converted from your price currency ({{ fxView.base }}) at the rate below, and an issued invoice keeps the rate it was issued with.
E-invoices (MyInvois)
Submit issued invoices to LHDN's MyInvois. Each customer needs its buyer details (Invoicing button): TIN, ID, address and phone. A validated e-invoice shows its validation link and QR code on the printed invoice. Document version 1.0 needs no digital signature until LHDN retires it; version 1.1 signs every e-invoice and credit note with your digital certificate (below). Try the sandbox first. The secret shows as ••••••••; leave it unchanged to keep the saved value.
Kept encrypted in the portal and never shown again. You are warned 30 days before it expires.
Single sign-on
Let your people sign in with their Google or Microsoft account. Only people who already have a portal login can use it, matched by the email the provider has verified; nobody is created this way. Admins and managers still unlock customer data with their passkey. Secrets show as ••••••••; leave them unchanged to keep the saved value.
Single sign-on needs the portal to run on a domain with https.
{{ u }}{{ u }}email and xms_edov, so Microsoft confirms the email's domain.Online payments
Let customers pay sent invoices by card or online banking. Their managers get a Pay online button, and you can copy the payment link from an invoice's More menu. The invoice is marked paid when the provider confirms the payment. Off until a provider is turned on. Secrets show as ••••••••; leave them unchanged to keep the saved value.
{{ payHooks.billplz }}{{ payHooks.stripe }}, with the events checkout.session.completed and checkout.session.async_payment_succeeded.Customers buying credit
Let managers of prepaid customers buy credit online with the providers above. The credit is added when the provider confirms the payment, once per payment, and shows in the customer's credit history.
Recent payments
| Invoice | Customer | Amount | Provider | Status | Opened |
|---|---|---|---|---|---|
| No online payments yet. | |||||
{{ p.number }}Prepaid credit |
{{ paymentCustomer(p) }} | {{ p.currency }} {{ money(p.amount / 100) }} | {{ providerName(p.provider) }}{{ p.ref }} |
{{ p.status }} {{ p.note }} |
{{ new Date(p.created_at).toLocaleString() }} {{ p.created_by }} |
Data warehouse export
Every night, shortly after midnight UTC, the previous day's data is copied to your S3 bucket (or any S3-compatible store) as gzipped CSV, one folder per day: {{ whCfg.prefix || 'relaykin' }}/message_log/date=YYYY-MM-DD/part-0.csv.gz, with a _schema.json describing the columns. Missed or failed days are caught up for up to {{ whCatchUp }} days. Message text is never exported. Off until turned on. The secret key shows as ••••••••; leave it unchanged to keep the saved value.
The access key needs permission to write objects (s3:PutObject) under the prefix; nothing is read or deleted.
Recent exports
| Day | Dataset | Status | Rows | Size | Run | |
|---|---|---|---|---|---|---|
| No exports yet. | ||||||
| {{ e.day }} | {{ datasetName(e.dataset) }}{{ e.object_key }} |
{{ e.status }} {{ e.error }} |
{{ e.rows }} | {{ (e.bytes / 1024).toFixed(1) }} KB | {{ new Date(e.started_at).toLocaleString() }} {{ e.run_by === 'schedule' ? 'nightly' : e.run_by }} · try {{ e.attempts }} |
|
Prices
What customers pay. Messages are priced per channel; received messages are usually free (0). Subscription prices apply to customers on a subscription plan, monthly or yearly. Invoices use these unless a customer has its own prices. Unit prices can be fractions of a cent, such as 0.035.
Volume tiers
Charge less per unit as a customer's monthly volume grows. Each band is charged at its own rate: with 0.05 up to 10,000 and 0.04 above, 12,000 messages cost 10,000 × 0.05 + 2,000 × 0.04. A price with tiers uses them instead of its single rate. Volume is counted per customer per calendar month, and invoices show one line per band.
Published on the landing page: {{ publishedText() }} per message sent, by monthly volume. Received messages, SMS parts and AI calls are not published and stay as they are. The published prices are in {{ published.currency }}, so they can't be applied to prices in {{ prices.currency }}.
A customer's own prices
Leave a field empty to use the price above.
Volume tiers for this customer
Tiers here replace the portal's tiers for that price. A single price above, with no tiers here, replaces the portal's tiers too.
Notifications on this device
Get a notification when a chat needs you and for alerts, even with the portal closed. On iPhone, first add the portal to the Home Screen (Share → Add to Home Screen) and open it from there.
This browser can't show notifications from the portal.
{{ pushInfo.on ? 'On for this device.' : 'Off for this device.' }} {{ pushInfo.devices }} device(s) of yours receive notifications.
Public status page
A page anyone with the link can open, showing your accounts by name with their state, 30-day uptime and recent outages. No phone numbers or technical details.
Alerts for your accounts
Hear about your accounts going down, being logged out or a phone going offline, by webhook, Telegram or email.
Email reports
A monthly report (with your invoice attached once it is issued) and an optional weekly one, emailed to the addresses you choose: messages sent, delivered, read, failed and received per channel, your busiest accounts and your credit.
Weekly summary
A summary of your accounts each week (messages, delivery, usage against your limits and open alerts), sent to the channels under “Alerts for your accounts”.
{{ digest.body }}
Set up an alert channel first, so the summary has somewhere to go.
Saved replies
One-click answers in the Inbox. Agents can use them; only {{ isAdmin ? 'admins and managers' : 'managers' }} can change them.
Message templates
Messages to reuse in the Inbox, campaigns and the API (template_id in POST /v1/messages), on every channel. Use {{name}}, {{phone}} or any other {{word}}.
Export your data
Everything RelayKin holds for your accounts: contacts, consent, opt-outs, campaigns and results, saved replies, templates, automatic replies, API key details (never secrets), monthly usage and each account's chats. You confirm who you are first.
ChatGPT connection
Connect a ChatGPT subscription for text AI (POST /v1/ai/respond). Voice notes and text-to-voice use the separate API key in .env.
PORTAL_SECRET_KEY in portal/.env and restart the portal. It encrypts the stored tokens.Failed {{ ai.device.error }}
1. Open {{ ai.device.verification_url }} and sign in to ChatGPT.
2. Enter this code: {{ ai.device.user_code }}
Waiting for you to finish… this page updates by itself. The code works for 15 minutes.
{{ ai.connection.email || ai.connection.account_id }} {{ ai.connection.plan || 'plan unknown' }} {{ ai.connection.status==='ok' ? 'Connected' : 'Reconnect needed' }}
{{ ai.connection.last_error }}
Models: {{ m }}none found yet
Refused by the account: {{ m }}
Last 24 hours: {{ ai.usage_24h.calls }} calls ({{ ai.usage_24h.failed }} failed), {{ ai.usage_24h.input_tokens }} tokens in, {{ ai.usage_24h.output_tokens }} tokens out.
No ChatGPT account is connected.
Test
{{ aiResult.model }} {{ aiResult.text }}
Uptime checks
An outside uptime service, such as Healthchecks.io or Better Stack, alerts you when pings stop: the one fault the portal cannot report itself. Create a check there and paste its ping address here. Saved addresses are stored encrypted and shown shortened.
Failure-rate alerts
Checked every 5 minutes, per account and per customer. You are told through your alert channels; a customer is told through its own alert channels and its managers' devices. A warning clears once the rate falls 5 points below the level, and stays quiet for 30 minutes after.
| Customer | Rate | Minimum | Window | ||||
|---|---|---|---|---|---|---|---|
| {{ customerName(Number(id)) }} | Off | {{ o.threshold_pct || failCfg.threshold_pct }}% | {{ o.min_messages || failCfg.min_messages }} | {{ o.window_minutes || failCfg.window_minutes }} min | |||
Blank fields use the values above.
Alert channels
Secrets show as ••••••••; leave them unchanged to keep the saved value. Each channel fires at or above its minimum level. Calls only ring for new critical problems.
Quiet hours and bundling
Alerts that can wait are held and sent as one digest. Critical alerts (an account down, credit run out) and security events always go at once.
{{ heldWhen(heldOwner) }}
{{ heldOwner.failed_week }} held alert(s) this week could not be delivered after several tries. Check the channels above.
Daily summary
One message each morning to the Telegram, email, WhatsApp and webhook channels above, whatever their minimum level (never a phone call): new and open tickets, low prepaid credit, customers in testing, accounts disconnected or logged out, and yesterday's credit and messages. If the time falls inside quiet hours, it goes when they end.
Turn on a Telegram, email, WhatsApp or webhook channel above, so the summary has somewhere to go.
Next summary: {{ time(daily.next) }}
Last sent {{ time(daily.status.sent_at) }}
Last try {{ time(daily.status.tried_at) }}: {{ daily.status.error }}
{{ dailyPreview.body }}