# Notification আর ইমেইল alert

> Tokens আপনার অ্যাকাউন্টে যত ইমেইল পাঠায়: Notifications পেজ থেকে কোনগুলো চালু বা বন্ধ করা যায়, কোনটা কখন যায়, threshold আর ডিফল্ট কী, আর delivery history কীভাবে পড়বেন।

টাকা আর limit নিয়ে Tokens আপনাকে ইমেইলে জানিয়ে রাখে, যাতে লম্বা agent session শেষে হঠাৎ চমকাতে না হয়। এই পেজে আছে অ্যাকাউন্টে যেসব ইমেইল যায়, তার কোনগুলো বন্ধ করা যায়, কোনটা কী কারণে আসে, আর ইমেইল গেছে কি না কীভাবে দেখবেন। Alert-এর পেছনের usage সংখ্যাগুলো দেখুন [usage, limit আর alert](/docs/usage-and-alerts) পেজে।

## Settings কোথায় পাবেন

Dashboard-এর sidebar-এ Account-এর নিচে [Notifications](/dashboard/notifications) খুলুন। পেজের নাম **Email Alerts & Notifications**, আর এতে তিনটা অংশ আছে:

- **Billing & Lifecycle Alerts**: receipt, renewal reminder, পেমেন্ট ব্যর্থ হওয়ার খবর আর কম Wallet ব্যালান্সের alert।
- **Token Quota Milestones**: plan-এর credit খরচ হতে হতে কখন কত ছুঁলো, তার warning।
- **Delivery History & Audit Trail**: আপনাকে যেসব ইমেইল গেছে তার log।

প্রতিটা switch একটা checkbox, ক্লিক করলেই সঙ্গে সঙ্গে save হয়ে যায়। কাজ হলে পেজে "Notification preferences successfully updated and saved." দেখাবে। Settings load না হলে switch-গুলো বন্ধ হয়ে থাকে আর title-এর পাশের badge-এ Unavailable লেখা আসে। তখন **Refresh** চেপে আবার চেষ্টা করুন।

[Settings](/dashboard/settings)-এর **Notifications** tab-এ একই বিষয়গুলোর একটা read-only সারাংশ আছে, সাথে এই পেজের link। ওখানকার "Enabled" badge স্থির লেখা, আপনার switch-এর সাথে বদলায় না। তাই আসল অবস্থা দেখতে Notifications পেজই ধরুন।

:::note[নোট]
সব alert-ই ইমেইল। ইমেইল যায় আপনার অ্যাকাউন্টের ইমেইল ঠিকানায়। এই alert-গুলোর জন্য Tokens-এ SMS, push বা Dashboard-এর ভেতরের কোনো notification নেই।
:::

## যে alert চালু বা বন্ধ করা যায়

নিচের সবকিছু প্রতিটা অ্যাকাউন্টে **ডিফল্টে চালু**। আপনার পছন্দ অ্যাকাউন্টের জন্য জমা থাকে, আলাদা API key-র জন্য নয়।

| পেজের switch                   | কীসে চালু হয়                                                                         | কখন যায়                                                  |
| ------------------------------ | ------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| Checkout & Wallet Receipts     | Payment provider একটা subscription checkout বা Wallet-এ টাকা যোগ করা confirm করলে      | পেমেন্ট confirm হওয়ার পরপরই                              |
| Subscription Renewal Reminders | আপনার paid plan-এর period শেষ হতে 3 দিনের মধ্যে                                        | প্রতি plan period-এ একবার                                 |
| Payment Failure Notices        | Payment provider কোনো পেমেন্ট ব্যর্থ বা বাতিল জানালে                                    | ব্যর্থতার খবর আসার পরপরই                                  |
| Low Wallet Balance Alerts      | আপনার USD Wallet-এর ব্যালান্স $5.00-এর নিচে নামলে                                      | ব্যালান্স threshold-এর নিচে থাকলে দিনে বড়জোর একবার      |
| Token Quota Milestones         | Plan-এর credit-এর যত অংশ খরচ করেছেন তা 50%, 75%, 90% বা 100% ছুঁলে                       | প্রতি plan period-এ প্রতিটা threshold-এ একবার             |

### Checkout & Wallet Receipts

পেজে এর বর্ণনা: "Receive verified receipts for subscription checkouts and prepaid credit deposits." Payment provider পেমেন্ট confirm করলে ইমেইল যায়, plan কেনা আর Wallet-এ টাকা যোগ করা, দুই ক্ষেত্রেই। ইমেইলে থাকে invoice নম্বর, পরিমাণ, currency আর পেমেন্টের মাধ্যম। প্রিন্ট করার মতো receipt [billing](/dashboard/billing) পেজেও পাবেন।

Manual পেমেন্ট (transaction id দিয়ে জমা দেওয়া bank বা mobile wallet transfer) এর নিজস্ব ইমেইল আছে। সেগুলো পরের অংশে।

### Subscription Renewal Reminders

Plan period শেষ হওয়ার প্রায় 3 দিন আগে যায়। ইমেইলে থাকে plan-এর নাম, তারিখ আর দাম। কোডে যে নিয়মগুলো আছে:

- শুধু paid plan reminder পায়। Free plan আর শূন্য দামের plan পায় না।
- পরের period-এর টাকা আগেই দেওয়া থাকলে reminder যায় না।
- প্রতি period-এ একটাই reminder আসে।

Plan নিজে থেকে renew হয় না, তাই এই ইমেইল মানে পরের period-এর টাকা দেওয়ার সময় হয়েছে। দেখুন [plan, credit আর Wallet](/docs/plans-and-wallet)।

### Payment Failure Notices

আপনার শুরু করা কোনো পেমেন্ট ব্যর্থ বা বাতিল হলে যায়। ইমেইলে লেখা থাকে পেমেন্টটা হয়নি আর কত টাকার ছিল। [billing](/dashboard/billing) থেকে আবার পেমেন্ট শুরু করুন।

### Low Wallet Balance Alerts

পেজে বর্ণনা: "Receive an email when your prepaid wallet drops below $5.00 USD to prevent API request dropouts." বিস্তারিত:

- হিসাব হয় আপনার **USD Wallet**-এর। BDT Wallet-এর ব্যালান্স কমলে এই ইমেইল যায় না।
- Threshold $5.00। পেজে এটা বদলানোর কোনো field নেই।
- ব্যালান্স threshold-এর নিচে থাকলে দিনে বড়জোর একটা ইমেইল পাবেন। টাকা যোগ করলে alert বন্ধ হয়ে যায়।

[Wallet](/dashboard/wallet) পেজের নিজস্ব "Low Balance" badge আছে, যার সীমা আলাদা (USD Wallet-এর জন্য $1)। Badge আর ইমেইল দুটো একে অপরের ওপর নির্ভর করে না।

### Token Quota Milestones

Plan-এর credit ফুরিয়ে যাওয়ার আগেই এই ইমেইল সতর্ক করে। শতাংশটা হলো এই period-এ আপনার active plan-এর credit pool-এর কত অংশ খরচ হয়েছে। চারটা row:

| Row  | পেজে লেখা label                  |
| ---- | -------------------------------- |
| 50%  | Halfway threshold reached        |
| 75%  | Three quarters threshold warning |
| 90%  | Critical quota warning           |
| 100% | Quota exhausted notification     |

কীভাবে কাজ করে:

- **Enable All** (card-এর ওপরে ডানে) পুরো গ্রুপের master switch। এটা বন্ধ করলে চারটা row-র switch অকেজো হয়ে যায় আর কোনো milestone ইমেইল যায় না। আবার চালু করলে চারটা row আগে যেমন ছিল তেমনই ফিরে আসে।
- প্রতিটা row আলাদা করে চালু বা বন্ধ করা যায়।
- প্রতিটা milestone এক plan period-এ একবারই যায়। দুটো check-এর মাঝে usage একসাথে কয়েকটা milestone পেরিয়ে গেলে প্রতিটার জন্য একটা করে ইমেইল পাবেন।
- কোনো milestone পেরিয়ে যাওয়ার পরে সেটা চালু করলে ইমেইল যাবে পরের check-এ।
- এই ইমেইল শুধু active plan আছে এমন অ্যাকাউন্টের জন্য। এগুলো plan-এর credit pool দেখে, তাই শুধু Wallet-এ চলা অ্যাকাউন্টে খাটে না।

Alert-গুলো তৈরি করে একটা scheduled check, যা প্রায় প্রতি পাঁচ মিনিটে চলে। তাই threshold ছোঁয়ার ঠিক সেই request-এ নয়, কয়েক মিনিট পরে ইমেইল আসতে পারে। পাঠাতে ব্যর্থ হলে একই period-এ সর্বোচ্চ 3 বার আবার চেষ্টা হয়।

## যে ইমেইলের switch নেই

### Usage window ও model allowance-এর warning

আপনার plan-এ usage window থাকলে (যেমন 5 ঘণ্টার session বা সাপ্তাহিক ceiling), window-র **80%**-এ একটা warning আর **100%**-এ একটা notice পাবেন। কোনো plan যদি একটা model-এর ওপর আলাদা খরচের সীমা বেঁধে দেয়, ওই model-এর জন্যও একই দুটো ইমেইল যায় ("... 80% of its allowance used", "... allowance used up")।

এগুলো ডিফল্টে চালু। Notifications পেজে এদের কোনো switch দেখানো হয় না, তাই Dashboard থেকে বন্ধ করা যায় না। প্রতিটা window বা model এই দুটো ইমেইল প্রতি window বা period-এ একবার করে পাঠায়। Window-গুলো নিজে দেখতে Usage পেজ খুলুন, অথবা `GET /v1/tokens/usage` ব্যবহার করুন, যেমন আছে [usage, limit আর alert](/docs/usage-and-alerts) পেজে।

### পেমেন্ট ও অ্যাকাউন্টের ইমেইল

ঘটনাটা ঘটলেই এগুলো সবসময় যায়:

| ইমেইল                               | কখন                                                                            |
| ----------------------------------- | ------------------------------------------------------------------------------ |
| We received your payment details    | Plan বা টাকা যোগ করার জন্য manual পেমেন্ট (transaction id) জমা দিলে               |
| Payment approved                    | Staff আপনার manual পেমেন্ট confirm করলে                                         |
| Payment rejected                    | Staff আপনার manual পেমেন্ট যাচাই করতে না পারলে; ইমেইলে কারণ লেখা থাকে            |
| Confirm your email address          | অ্যাকাউন্ট খুললে                                                                |
| Reset your password, sign-in link   | পাসওয়ার্ড reset বা sign-in link চাইলে                                          |
| Confirm your email change           | আপনার অ্যাকাউন্টের ইমেইল বদলানোর অনুরোধ এলে                                     |
| Support ticket reply, ticket closed | আপনার খোলা ticket-এ staff উত্তর দিলে বা ticket বন্ধ করলে                        |

Support-এর ইমেইলে [আপনার ticket](/dashboard/support)-এর link থাকে। পুরো কথোপকথন Dashboard-এই থাকে।

## Delivery history

**Delivery History & Audit Trail** table-এ আপনার অ্যাকাউন্টের নামে লেখা ইমেইলগুলো আসে, সবচেয়ে নতুনটা ওপরে। Badge-এ দেখা যায় কয়টা record load হয়েছে। পেজ সর্বশেষ 20টা load করে। Column-গুলো:

| Column     | মানে                                                          |
| ---------- | ------------------------------------------------------------- |
| Event Type | ইমেইলের ভেতরের নাম, যেমন `checkout_receipt`                   |
| Subject    | ইমেইলের subject                                               |
| Recipient  | যে ঠিকানায় গেছে                                              |
| Status     | `sent`, `failed`, `suppressed`, বা `sent (test mode)`         |
| Timestamp  | কখন record হয়েছে, আপনার browser-এর time zone অনুযায়ী        |

Status-গুলোর মানে:

- **sent**: ইমেইল provider-এর হাতে পৌঁছে দেওয়া হয়েছে।
- **failed**: provider বা mail server ইমেইল নেয়নি। Milestone, renewal আর window alert প্ল্যাটফর্ম প্রতি period-এ সর্বোচ্চ 3 বার আবার পাঠানোর চেষ্টা করে।
- **suppressed**: ইমেইল পাঠানোর কথা ছিল, কিন্তু ওই alert আপনি বন্ধ রেখেছিলেন (বা আপনার ঠিকানা খুঁজে পাওয়া যায়নি), তাই কিছু যায়নি। Receipt, পেমেন্ট ব্যর্থতা ও এ ধরনের alert এমন row রেখে যায়। Quota milestone, renewal reminder আর low balance alert পাঠানোর আগেই যাচাই হয়, তাই বন্ধ করা থাকলে কোনো row-ই পড়ে না।
- **sent (test mode)**: প্ল্যাটফর্মের ইমেইল provider test mode-এ আছে, তাই বার্তা record হয়েছে কিন্তু পৌঁছায়নি।

Table খালি থাকলে লেখা আসে "No notification events recorded yet. Complete a checkout to create one." Confirmation link আর support ticket-এর মতো অ্যাকাউন্টের ইমেইল log-এ আপনার user record-এর সাথে বাঁধা থাকে না, তাই সেগুলো এই table-এ দেখা যায় না।

## ইমেইল না এলে

1. Delivery history table দেখুন। Row-তে `suppressed` লেখা থাকলে alert-টা আবার চালু করুন।
2. কোনো row না থাকলে হয়তো ঘটনাটা এখনও ঘটেনি। Milestone আর reminder তৈরি করে scheduled check, তাই কয়েক মিনিট সময় দিন।
3. Spam folder দেখুন, আর [Settings](/dashboard/settings)-এর ঠিকানাটাই যে আপনি পড়েন তা মিলিয়ে নিন।
4. Row-তে `failed` থাকলে, অথবা ইমেইল আশা করেও কোনো record না পেলে, event type আর সময় [support](/docs/support)-কে জানান।

## আরও পড়ুন

- [Usage, limit আর alert](/docs/usage-and-alerts)
- [Plan, credit আর Wallet](/docs/plans-and-wallet)
- [Account settings](/docs/account-settings)
- [সাহায্য পাওয়া](/docs/support)

---
Page: https://tokens.bd/bn/docs/notifications