# Contact us (/contact-us)
## Billing & subscriptions [#billing--subscriptions]
You can manage most subscription changes from the Stripe portal linked through [pricing](https://app.mailg.io/pricing). For refunds or payment issues, email us.
## Everything else [#everything-else]
Email **[contact@mailg.io](mailto:contact@mailg.io)**.
We usually reply within one business day.
## Useful links [#useful-links]
* [Website](https://www.mailg.io)
* [Pricing](https://app.mailg.io/pricing)
* [Privacy](https://www.mailg.io/privacy)
* [Terms](https://www.mailg.io/terms)
* [Documentation home](/)
# MailG documentation (/)
MailG is a Google Sheets add-on for mail merge with Gmail. Open **Extensions → MailG for Gmail → 🚀 Start**, build a template, preview rows, then send or schedule from your own Gmail account.
## Start here [#start-here]
## Popular topics [#popular-topics]
## Useful links [#useful-links]
* Website: [www.mailg.io](https://www.mailg.io)
* Pricing: [app.mailg.io/pricing](https://app.mailg.io/pricing)
* Marketplace: [Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg)
* Contact: [contact@mailg.io](mailto:contact@mailg.io)
## For AI assistants / LLMs [#for-ai-assistants--llms]
Prefer these machine-readable endpoints over scraping HTML:
* [Agents hub](https://www.mailg.io/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/help/faq)
## Installation & open [#installation--open]
**How do I open MailG?**\
**Extensions → MailG for Gmail → 🚀 Start**. See [Installation](/getting-started/installation).
**No email address found in your sheet**\
Add emails to a column, or click **Fill with mock data**. See [Start dialog tour](/getting-started/start-dialog).
**Could not reach the MailG API**\
Check network / API URL (self-hosted: `APP_URL` + `APP_API_KEY`). Reopen the dialog after fixing.
## Sending [#sending]
**Emails are not sending**\
Check **Daily quota**, Gmail permissions, and that **Recipient column** cells are valid single emails. Failures show **⚠️ Failed**.
**Do subject merge tags work?**\
Not yet. Only the **body** is merged. Keep a fixed subject or put personalization in the body. See [Merge tags](/features/merge-tags).
**Can I attach files?**\
The **Attachments** picker exists under **More options**, but files are not attached on send yet. Link a Drive or HTTPS file in the body instead — see [Attachments](/features/attachments).
**How do I add images?**\
There is no image embed control. Host the file (Drive **Anyone with the link / Viewer** works) and use **Insert link**. See [Images](/features/images).
**How do I stop a campaign?**\
[Stopping a campaign](/features/stopping-a-campaign) — clear sendable statuses on remaining rows. There is no Abort / Pause UI yet.
**Does MailG add an unsubscribe link?**\
Not yet. For cold or marketing mail, put your own opt-out URL in the body if you need one. Built-in One-Click Unsubscribe is on the roadmap (see [Features overview](/features/features-overview)).
**Why am I limited on Professional?**\
MailG may allow up to 1,500/day, but free `@gmail.com` is often capped near 500 by Google. CC/BCC also count toward **Gmail** recipients — see [Multiple recipients](/features/multiple-recipients).
## Tracking [#tracking]
**Sheet still says Sent after an open**\
**🔄 Refresh Tracking** → expect `Tracking info synced`. Some clients never load images.
**Clicks?**\
Not tracked. **Track emails** = opens only.
## Quota & billing [#quota--billing]
See [Daily quota & reviews](/help/daily-quota-and-reviews) and [Account & billing](/help/account-and-billing).
**Is Schedule send paid?**\
No. Paid unlocks higher quotas, pacing modes, and **Remove branding**.
## Troubleshooting [#troubleshooting]
For step-by-step fixes (API errors, empty sheet, disabled send button, failed rows, tracking, quota, schedule not deferring), see [Troubleshooting](/help/troubleshooting).
Common toasts you may see:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Still stuck? [#still-stuck]
[Troubleshooting](/help/troubleshooting) · Docs [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Troubleshooting (/help/troubleshooting)
Quick fixes for the messages and states you see in the add-on.
## Dialog will not load [#dialog-will-not-load]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
The start dialog could not call the MailG backend.
* Confirm you are online
* Marketplace installs: wait a moment and reopen **🚀 Start**
* Self-hosted: check Apps Script properties `APP_URL` (public HTTPS) and `APP_API_KEY`
* The add-on cannot use `localhost` — use a tunnel for local API testing
### Could not read your sheet [#could-not-read-your-sheet]
MailG failed to read the active spreadsheet.
* Make sure a sheet tab is open (not only the Apps Script editor)
* Reload the spreadsheet, then reopen the dialog
* Confirm you have edit access to the file
### Loading… never finishes [#loading-never-finishes]
Close the dialog, refresh Sheets, wait \~15 seconds for Extensions, then **🚀 Start** again.
## Empty sheet [#empty-sheet]
**No email address found in your sheet**
MailG needs at least one column with valid email addresses.
* Add emails under a header, or click **Fill with mock data**
* Mock data creates `Email`, `First Name`, `Last Name`, `Company` and often **My First Template**
See [Start dialog tour](/getting-started/start-dialog).
## Templates [#templates]
* Create: `Creating Template...` → `Template created successfully!` or `Failed to create template! Try again later.`
* Update: `Updating template...`
* Delete failures: `Failed to delete template. Try again later`
See [Templates](/features/templates).
## Sending problems [#sending-problems]
### Send button disabled / Send emails with no count [#send-button-disabled--send-emails-with-no-count]
* Select a **Template**
* Select a **Recipient column** with valid **single** emails per cell
* Guard toasts you may see: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### Campaign fails to start [#campaign-fails-to-start]
Toast: `Failed to create campaign. Please try again.`
* Retry once
* Check **Daily quota** is not 0
* Confirm API connectivity (see above)
### Rows show ⚠️ Failed [#rows-show-️-failed]
That row hit a send error (invalid address, Gmail rejection, transient quota, etc.). Fix the data and start a new campaign for remaining rows, or see [Stopping a campaign](/features/stopping-a-campaign).
### Test email fails [#test-email-fails]
* `Configure your preview first` — pick template + recipient so preview has a To
* `Failed to send test email. Please check your email settings.` — re-authorize Gmail if needed, then retry
## Tracking [#tracking]
* Opens need remote images loaded by the recipient
* Run **🔄 Refresh Tracking** — expect `Tracking info synced` or `No active campaigns`
* Status **👀 Opened** only appears when the pixel loads
See [Email tracking](/features/email-tracking).
## Quota & branding [#quota--branding]
* Sidebar **N left** is `min(MailG remaining, Gmail remaining)`
* Free `@gmail.com` is often capped near 500/day by Google even on Professional
* Watermark still there after pay → checkout email must match Sheets account; reopen the dialog
See [Daily quota & reviews](/help/daily-quota-and-reviews) and [Remove branding](/features/remove-branding).
## Schedule did not defer [#schedule-did-not-defer]
Times less than about **15 seconds** ahead are treated as an **immediate** send (🚀 column), not a deferred 🗓️ schedule. Pick a time further in the future.
## Still stuck? [#still-stuck]
Full FAQ: [FAQ](/help/faq) · Email [contact@mailg.io](mailto:contact@mailg.io) · Site [app.mailg.io/help](https://www.mailg.io/help)
# Daily quota and reviews (/help/daily-quota-and-reviews)
The root sidebar shows your sending capacity when account data is loaded.
## Daily quota block [#daily-quota-block]
Exact UI:
* Label: **Daily quota**
* Remaining: **N left**
* Plan line: **Your plan sends up to TOTAL/day**
**Remaining** is the minimum of:
1. MailG plan remaining for the day
2. Gmail remaining send quota for the account
So you can be capped by Gmail even when MailG still shows headroom on paper. See also [Account & billing](/help/account-and-billing).
## Free plan CTAs [#free-plan-ctas]
When you are not subscribed, the sidebar may show:
* **Leave a 5★ review for +N/day free** (default bonus is **+50/day** when the API does not specify otherwise)
* **Or upgrade your plan**
Clicking the review CTA opens **Free Quota upgrade**:
* Title: **Free Quota upgrade**
* Body: leave a 5-star review to get a free quota upgrade of **+N emails/day**
* Buttons: **Not now** | **Leave a 5★ review**
If the review URL is not configured, **Leave a 5★ review** stays disabled — use **Upgrade to Pro** / pricing instead.
## Upgrade to Pro [#upgrade-to-pro]
Footer button (free accounts): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
That matches what paid plans unlock in the product today.
## Related [#related]
* [Remove branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Account & billing (/help/account-and-billing)
MailG billing is tied to the **email of your Google account** in Sheets. Always check out with that same address so quotas unlock in the add-on.
## Plans & daily quotas [#plans--daily-quotas]
| Plan | Daily quota | Notes |
| ------------ | ----------- | ------------------------------------- |
| Free | 50 | Core merge, open tracking, scheduling |
| Personal | 250 | Popular plan for growing lists |
| Professional | 1,500 | Highest recurring quota |
| Lifetime | 1,500 | One-time purchase |
Prices and intervals are listed on [app.mailg.io/pricing](https://app.mailg.io/pricing) (EUR and USD).
Paid entitlements also unlock:
* Non-default [send pacing](/features/send-pacing) (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Your effective send volume is `min(MailG daily quota, Gmail remaining quota)`.
## How to upgrade [#how-to-upgrade]
1. Open [pricing](https://app.mailg.io/pricing) (also linked from the add-on via **Upgrade to Pro**).
2. Choose a plan and complete Stripe Checkout with your Sheets Google email.
3. Re-open MailG in Sheets so the account refresh picks up the new limit.
## Cancel or update a subscription [#cancel-or-update-a-subscription]
You can cancel or change your subscription from the Stripe customer portal linked on your subscription / pricing flow.
* If you cancel mid-cycle, Premium features stay active until the end of the paid period
* You will not be charged again after cancellation takes effect
## Refunds [#refunds]
If you cancel a Premium subscription within **30 days** of purchase, you may request a full refund by emailing [contact@mailg.io](mailto:contact@mailg.io).
## Invoices [#invoices]
Stripe emails receipts for successful payments. You can also download invoices from the Stripe customer portal used for subscription management.
## FAQ snippets [#faq-snippets]
**Is MailG included in Google Workspace?**\
No. MailG is independent of Google. A Workspace subscription does not include MailG.
**What payment methods are accepted?**\
Major cards, Google Pay, and Apple Pay via Stripe. PayPal is not supported.
**I paid but still see the free limit / watermark**\
Almost always an email mismatch. Confirm checkout email = Sheets account email, then reopen the add-on. If it persists, contact support with both emails.
**Why is free Gmail limited to about 500 emails per day?**\
MailG Professional allows up to 1,500 emails per day, but Google itself limits free `@gmail.com` accounts to roughly 500 sends per day. Google Workspace accounts can go higher. This is a Gmail provider limit, not a MailG limit.
# Campaign scheduling (/features/campaign-scheduling)
Use **Schedule send** when you want MailG to start later. Available on free and paid plans.
## How to schedule [#how-to-schedule]
1. Configure template and recipients so the send button is enabled.
2. Open the send menu (chevron) → **Schedule send**.
3. Dialog title: **Schedule send**
4. Description: `Pick date & time to schedule sending`
5. Summary line: scheduling N emails to be sent starting at the chosen date/time
6. Use the date picker plus **Hour** / **Minute** (placeholders `Hour`, `Min`).
7. Confirm with **Schedule Send** (or **Cancel**).
Default suggestion is about **60 minutes ahead**, snapped to the next **15-minute** step.
## Immediate vs scheduled [#immediate-vs-scheduled]
Times less than about **15 seconds** ahead are treated as an **immediate** send (🚀 column header), not a deferred 🗓️ schedule. Pick a time further in the future if you need deferred sending.
Validation toasts: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Success toast: campaign scheduled; N emails will start at the chosen time.
## Sheet column [#sheet-column]
Scheduled campaigns create a column header like:
```text
🗓️ Template name (yyyy/MM/dd)
```
Immediate sends use 🚀 instead of 🗓️.
Rows start as **🗓️ Scheduled**, then move to **⏳ Sending…** when the queue runs.
## After you schedule [#after-you-schedule]
* Keep the spreadsheet accessible to the Google account that owns the add-on
* Tracking and pacing still apply once sending starts
* No **Manage Schedule** UI — see [Stopping a campaign](/features/stopping-a-campaign)
## Related [#related]
* [Preview & test](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Multiple recipients (/features/multiple-recipients)
You can add carbon-copy recipients per row with dedicated sheet columns.
## Recipient column (To) [#recipient-column-to]
Select **Recipient column** in the sidebar.
For the send button count and column validation, MailG treats a cell as valid when it is a **single** email address. Prefer one primary To address per row.
Putting several addresses separated by commas in the **Recipient column** is not supported for the add-on’s validation and row count. Use **CC** / **BCC** columns (or extra rows) instead.
## CC and BCC columns [#cc-and-bcc-columns]
1. Add columns in the sheet (for example `CC` and `BCC`).
2. Put an email in the cell (Gmail may accept a list in that cell depending on how you format it — keep it simple when possible).
3. Open **More options** and map **CC** / **BCC**.
4. At send time, those values are passed to Gmail.
The preview pane shows **From**, **To**, **Subject**, and body only. It does **not** display CC/BCC lines even when mapped. Confirm with **Send me a test email** if you need to verify CC/BCC delivery.
## Quotas: MailG vs Gmail [#quotas-mailg-vs-gmail]
These limits are **different**:
| Counter | What it counts |
| ------------------------ | -------------------------------------------------------------- |
| **MailG daily quota** | Campaign **rows** processed (one row ≈ one campaign email job) |
| **Gmail sending limits** | **Recipients** Google accepts on that send (To + CC + BCC) |
### Examples (Gmail recipient count) [#examples-gmail-recipient-count]
| Row content | MailG quota | Gmail recipients |
| ------------------- | ----------- | ---------------- |
| 1 To only | −1 row | 1 |
| 1 To + 1 CC + 1 BCC | −1 row | **3** |
| 1 To + 2 CC | −1 row | **3** |
You can still hit Gmail’s daily recipient cap while MailG quota remains. Spreading sends with [send pacing](/features/send-pacing) helps the account look less like a sudden blast, but it does not raise Google’s hard limits.
## Tips [#tips]
* Prefer **BCC** when recipients should not see each other
* Leave CC/BCC unmapped when unused
* Validate addresses before a large send
* For large lists, check both MailG remaining quota and your Google account type (personal Gmail vs Workspace)
## Related [#related]
* [Send pacing](/features/send-pacing)
* [Daily quota & reviews](/help/daily-quota-and-reviews)
* [Preview & test](/features/preview-and-test)
# Attachments (/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Features overview (/features/features-overview)
What the add-on supports today:
| Feature | Docs |
| ------------------------------------------- | ------------------------------------------------------ |
| Start dialog / empty sheet / mock data | [Start dialog tour](/getting-started/start-dialog) |
| Templates (create / manage / edit / delete) | [Templates](/features/templates) |
| Merge tags in **body** | [Merge tags](/features/merge-tags) |
| Rich-text toolbar | [Rich-text emails](/features/rich-text-emails) |
| Links (not image embeds) | [Images](/features/images) |
| Attachments (UI only — not sent) | [Attachments](/features/attachments) |
| Preview + test email | [Preview & test](/features/preview-and-test) |
| Schedule send | [Campaign scheduling](/features/campaign-scheduling) |
| Send pacing (paid) | [Send pacing](/features/send-pacing) |
| CC / BCC columns | [Multiple recipients](/features/multiple-recipients) |
| Track emails | [Email tracking](/features/email-tracking) |
| Sender name & reply-to | [Customized sender](/features/customized-sender) |
| Remove branding (paid) | [Remove branding](/features/remove-branding) |
| Stop remaining rows | [Stopping a campaign](/features/stopping-a-campaign) |
| Daily quota + review bonus | [Daily quota & reviews](/help/daily-quota-and-reviews) |
## Paid vs free [#paid-vs-free]
Paid unlocks:
* Non-default [send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* Higher [daily quotas](/help/account-and-billing)
**Schedule send**, **Track emails**, and template tools work without a paid upgrade.
## Known gaps (be honest) [#known-gaps-be-honest]
| Topic | Status in product |
| ----------------------- | ----------------------------------------------------------------- |
| Subject merge tags | Not applied at send — body only |
| Attachments column | UI only — not attached on send ([details](/features/attachments)) |
| Image embeds | No editor control — use [links](/features/images) |
| Preview CC/BCC lines | Not shown in preview UI |
| Manage Schedule / Pause | Not shipped — status workaround |
## Coming later [#coming-later]
Unsubscribe links, click tracking, shared team seats, and a dedicated campaign manager UI when they ship.
# Email tracking (/features/email-tracking)
MailG can record opens with a tiny invisible pixel.
## Enable tracking [#enable-tracking]
In the sidebar, leave **Track emails** on (default is on for new jobs).
Tooltip: `Track emails opened with a tiny pixel`
The help icon opens **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Button: **Got it**
## Sheet statuses [#sheet-statuses]
| Status | Meaning |
| ------------- | ------------------------------- |
| 🗓️ Scheduled | Waiting for the scheduled start |
| ⏳ Sending… | Currently being processed |
| ✉️ Sent | Delivered to Gmail for that row |
| ⚠️ Failed | Send error for that row |
| 👀 Opened | Open pixel was loaded |
Campaign column headers look like `🚀 Template name (yyyy/MM/dd)` or `🗓️ …` when scheduled.
## Refresh tracking [#refresh-tracking]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Apps Script alerts:
* `Tracking info synced`
* `No active campaigns`
## Limitations [#limitations]
* Client must load remote images
* Privacy proxies can hide opens
* Opens only — not link clicks
## Related [#related]
* [Campaign scheduling](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Merge tags (/features/merge-tags)
Merge tags let each recipient get a personalized **body**. A tag is the **exact column header** wrapped in double curly braces.
## Syntax [#syntax]
If your sheet has a column named `First Name`, use:
```text
{{First Name}}
```
Body example:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Where merge tags work today [#where-merge-tags-work-today]
| Field | Merged at send? |
| --------------- | -------------------------------------------------- |
| Email body | **Yes** — variables injected per row |
| Email subject | **No** — subject is sent as stored in the template |
| Preview body | **Yes** — for the active row |
| Preview subject | **No** — shows the raw template subject |
Put personalization in the body until subject merge ships.
## Inserting tags [#inserting-tags]
In the editor toolbar, open **Merge Tag**. It lists headers from the active sheet. Empty state: `No sheet columns found`.
Inserted text uses double curly braces around the column name.
## Rules of thumb [#rules-of-thumb]
* Headers are case-sensitive (`Name` ≠ `name`)
* Empty cells insert as empty strings
* You can reuse the same tag multiple times in the body
* Recipient / CC / BCC are chosen under **More options**, not via merge tags
## Next [#next]
See [Rich-text emails](/features/rich-text-emails) and [Preview & test](/features/preview-and-test).
# Rich-text emails (/features/rich-text-emails)
MailG templates use a TipTap rich-text editor. The HTML it produces is what Gmail delivers.
Body placeholder: `Write your email…`
## Toolbar inventory (exact UI) [#toolbar-inventory-exact-ui]
| Group | Controls |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (presets in the toolbar) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | Preset swatches + native color picker + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — URL field placeholder `https://example.com`, then **Apply** (and unlink) |
| History | **Undo**, **Redo** |
## Not in the editor [#not-in-the-editor]
These TipTap features are disabled / absent:
* Headings, code, code block, blockquote, horizontal rule
* Image insert / Drive media picker — see [Images](/features/images)
## Hyperlinks [#hyperlinks]
Use **Insert link** for the URL and visible text. Prefer clear link text over raw URLs.
## Tips [#tips]
* Use **Merge Tag** instead of typing braces by hand
* Preview several rows before sending — see [Preview & test](/features/preview-and-test)
* Avoid huge pasted Word/Docs markup; re-apply formatting in MailG for cleaner HTML
# Remove MailG branding (/features/remove-branding)
Free campaigns may include a small MailG watermark in the email footer. Paid subscribers can turn it off.
## How to remove branding [#how-to-remove-branding]
1. Confirm you have an active paid plan (Personal, Professional, or Lifetime).
2. Open the campaign sidebar.
3. Enable **Remove branding**.
4. Preview a row to confirm the watermark is gone, then send.
If branding still appears after you paid:
* Make sure checkout used the **same email** as your Google Sheets account
* Re-open the add-on so it refreshes entitlements from the API
* Contact [contact@mailg.io](mailto:contact@mailg.io) with your Google account email
See [Account & billing](/help/account-and-billing).
# Images (/features/images)
The MailG editor has **no image insert button** and no Google Drive media picker. TipTap’s Image extension is not enabled.
## What you can do today [#what-you-can-do-today]
Use **Insert link** in the toolbar:
1. Host the image (or file) at a public URL, or share a Drive link (see below).
2. Select text (or place the cursor) → **Insert link**.
3. Paste the URL (placeholder `https://example.com`) → **Apply**.
Recipients open the link to view the image or file. The editor does not embed `![]()
` tags for you.
## Host an image on Google Drive (recommended) [#host-an-image-on-google-drive-recommended]
You cannot attach a file from your computer directly inside the email body. Host it online first — Google Drive works well:
1. Go to [Google Drive](https://drive.google.com/drive/my-drive) and upload the image.
2. Right-click the file → **Share** → set **General access** to **Anyone with the link**.
3. Role must be **Viewer** (not **Editor** — otherwise anyone with the link could change the file).
4. Copy the link.
5. In MailG, use **Insert link** and paste that URL on clear link text (for example “View screenshot”).
If the Drive file stays restricted to your account or organization, recipients will see an access error. Always test with **Send me a test email** from an account that is not the owner.
## Distant / CDN URLs [#distant--cdn-urls]
Any publicly reachable HTTPS image or file URL works the same way via **Insert link**. Prefer stable hosts (your site, object storage, or a CDN).
## Tips [#tips]
* Prefer small files and clear link text (“View screenshot”, “Open PDF”)
* Do not rely on HTML pastes that include `![]()
` — support varies by client and MailG does not manage embeds
* Confirm with **Send me a test email**
## Coming later [#coming-later]
A first-class image embed / Drive picker may ship later. Until then, hyperlinks are the supported path.
# Templates (/features/templates)
Templates store the subject and rich-text body you reuse across campaigns. They are saved to the MailG API for your Google account.
## Create a template [#create-a-template]
1. On the root screen, click **New Template**.
2. Fill in:
* **Template Name**
* **Email Subject**
* Body (rich editor — see [Rich-text emails](/features/rich-text-emails))
3. Click **Save Template** (shows **Saving...** while working).
Toasts:
* Loading: `Creating Template...`
* Success: `Template created successfully!`
* Error: `Failed to create template! Try again later.`
Demo template from **Fill with mock data**: name **My First Template**, subject `I found a mail merge tool for Gmail`.
## Manage templates [#manage-templates]
Open the template icon next to the template select (tooltip **Manage templates**).
Table columns:
| Column | Content |
| ----------------- | ------------- |
| **Name** | Template name |
| **Email Subject** | Subject line |
| **Created At** | Creation date |
| **Actions** | Row menu |
Row menu: **Edit** | **Delete**
Footer: **Back**
Delete toasts: deleting template NAME → template NAME deleted successfully (or a failure message).
## Edit a template [#edit-a-template]
Open **Edit** from manage, or click **Edit template** in the preview toolbar.
Same fields as create. **Save Template** updates the template.
The update flow shows a loading toast (`Updating template...`). Stay on the form until it finishes, then use **Cancel** or **Back** if you are not returned automatically.
## Subject vs body [#subject-vs-body]
* **Body** supports [merge tags](/features/merge-tags) — they are injected per row at send time.
* **Email Subject** is sent as stored today (merge tags in the subject are **not** replaced yet). Put personalization in the body, or use a fixed subject.
## Related [#related]
* [Preview & test](/features/preview-and-test)
* [Start dialog tour](/getting-started/start-dialog)
# Preview and test (/features/preview-and-test)
The preview pane (right side of the root dialog) shows how a message looks for the active sheet row.
## What the preview shows [#what-the-preview-shows]
| Field | Content |
| ------------ | -------------------------------------------------------------------------------------- |
| **From:** | Your signed-in Google account email |
| **To:** | Value from the **Recipient column** for the active row, or `Select a recipient column` |
| **Subject:** | Template subject as stored (not merge-substituted) |
| Body | Template body with merge tags applied for that row |
If **Remove branding** is off, the preview includes the MailG watermark footer (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## What is not shown [#what-is-not-shown]
* **CC** / **BCC** rows are not rendered in the preview UI (even when mapped under **More options**). They are still applied at send time.
* Attachment column values are not shown in preview.
## Navigate rows [#navigate-rows]
Preview toolbar:
* **Edit template** — opens the update-template screen
* **Previous recipient** / **Next recipient** — move between data rows (tooltips may include the sheet row number; header is row 1, so the first contact is row 2)
## Send me a test email [#send-me-a-test-email]
1. Configure template + recipient column so preview is valid.
2. Open the send menu (chevron) → **Send me a test email**.
3. Busy overlay: `Sending test email…`
4. Success toast: `Test email sent successfully. Check your inbox.`
5. Failure toast: `Failed to send test email. Please check your email settings.`
6. Guard if preview is incomplete: `Configure your preview first`
The test goes to **your** Google account inbox, using the active preview row’s merged body.
## Tips [#tips]
* Step through several rows with the arrows before a full send
* Confirm branding / no branding in preview
* Always test before **Schedule send** or a large **Send N email(s)**
## Related [#related]
* [Merge tags](/features/merge-tags)
* [Mail merge tutorial](/getting-started/mail-merge-tutorial)
# Send pacing (/features/send-pacing)
Send pacing adds delay between messages so a large campaign does not leave your account as a single burst.
**Steady pace** and **Jittered gaps** require an active paid MailG subscription. Free accounts use **Burst send** only.
## Where to configure [#where-to-configure]
Open the footer gear (tooltip **Send pacing**). Screen heading: **Send pacing**.
Under **Dispatch mode**, choose how emails are spaced. **Gap between emails** is set in **seconds** (0–60). Free accounts see **Pro features** and the locked copy: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Default for new jobs: **Burst send**, gap **10s** (gap ignored until you leave burst).
## Modes [#modes]
| Mode (UI label) | Behavior |
| ------------------------ | ----------------------------------------------- |
| **Burst send** (default) | Send as quickly as quotas allow |
| **Steady pace** | Wait a fixed gap between each email |
| **Jittered gaps** | Wait a random gap between 0 and your chosen max |
## Wall-clock duration (Steady pace) [#wall-clock-duration-steady-pace]
Rough estimate for **Steady pace**:
`rows × gap seconds ≈ total send time` (plus a little overhead)
| Rows | Gap | Approx. duration |
| ----- | --- | ---------------- |
| 60 | 10s | \~10 minutes |
| 250 | 10s | \~40 minutes |
| 250 | 30s | \~2 hours |
| 1,000 | 15s | \~4 hours |
Use a long gap only when you can leave Sheets / the account active enough for the job to finish. If you set the gap too high mid-run, see [Stopping a campaign](/features/stopping-a-campaign).
## Why use pacing [#why-use-pacing]
* Reduce the chance of looking like a sudden blast to mailbox providers
* Spread a long list across a quieter send window
* Stay within Gmail comfort zones for your account type
## Notes [#notes]
* Pacing is a campaign setting stored with the job — new sends use the current configuration
* Your effective speed is still capped by MailG daily quota **and** Gmail’s remaining send quota ([multiple recipients](/features/multiple-recipients) also multiply Gmail’s recipient count)
* Competitor tools sometimes express delay in minutes — MailG uses **seconds**
## Related [#related]
* [Stopping a campaign](/features/stopping-a-campaign) if a gap was set too high mid-run
* [Account & billing](/help/account-and-billing)
* [Daily quota & reviews](/help/daily-quota-and-reviews)
# Stopping a campaign (/features/stopping-a-campaign)
MailG does not yet ship a dedicated **Manage Schedule**, **Abort**, or **Pause** screen. You can still stop **remaining** rows from sending by changing campaign statuses in the sheet.
Pick the scenario that matches where you are:
## 1. Scheduled campaign that has not started [#1-scheduled-campaign-that-has-not-started]
If every row is still **🗓️ Scheduled** (or legacy `Scheduled`) and the start time has not arrived:
1. Open the spreadsheet.
2. Clear the campaign status cells (or the whole campaign column) for rows that must not send.
3. Optionally remove or change the schedule in the dialog before creating a new job.
When the clock reaches the old start time, the queue will not pick up rows that no longer have a sendable status.
## 2. Campaign already sending (mid-run) [#2-campaign-already-sending-mid-run]
Act quickly on a large campaign — the first rows may already be out:
1. Open the spreadsheet (keep the tab focused).
2. In the campaign status column, clear or change the status on rows that must **not** send (delete the cell value, or set a non-sendable label such as `Stopped`).
3. Leave already-**✉️ Sent** / **👀 Opened** rows alone.
### How sending decides what to process [#how-sending-decides-what-to-process]
The send loop only processes rows whose campaign-column status is still sendable:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
Rows already marked **✉️ Sent**, **⚠️ Failed**, or **👀 Opened** are skipped.
Rows you clear/change will no longer match the sendable statuses, so the queue skips them on the next pass.
## 3. Messages already sent [#3-messages-already-sent]
Gmail messages that already left the account cannot be unsent by MailG. Stopping only protects rows that have not been processed yet. There is no 5-second Abort dialog and no in-app “Undo send” for the whole campaign.
If you need help reconstructing what was sent, note the spreadsheet URL, campaign column, and approximate start time, then email [contact@mailg.io](mailto:contact@mailg.io).
## Related [#related]
* [Campaign scheduling](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Customized sender (/features/customized-sender)
By default, Gmail sends from the Google account that authorized MailG. You can still customize how your name appears and where replies go.
## Sender name [#sender-name]
1. Open **More options** in the campaign sidebar.
2. Set **Sender name** (placeholder `John Doe (Optional)`).
3. Recipients see that display name in their inbox (subject to Gmail’s usual presentation rules).
## Reply to address [#reply-to-address]
Set **Reply to address** (placeholder `john@doe.com (Optional)`) if replies should go somewhere other than the sending account.
## Notes [#notes]
* The underlying From address remains the authorized Gmail account — you cannot spoof another mailbox
* Invalid reply-to addresses can cause delivery or reply issues — use a mailbox you control
* Preview shows **From:** as your signed-in email; confirm reply-to with **Send me a test email**
* See [Preview & test](/features/preview-and-test)
# Start dialog tour (/getting-started/start-dialog)
Open the add-on with **Extensions → MailG for Gmail → 🚀 Start**. A 900×600 dialog titled **MailG for Gmail** opens.
## Screens [#screens]
| Screen | How you get there | Purpose |
| ------------------ | -------------------------------------------- | ----------------------------------------- |
| Root (composer) | Default after load | Pick template + recipients, preview, send |
| Create template | **New Template** | Name, subject, body |
| Manage templates | Template icon (tooltip **Manage templates**) | List, edit, delete |
| Update template | **Edit template** or row **Edit** | Edit an existing template |
| Settings | Footer gear (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | No valid email column | Prompt to add contacts or mock data |
| API / sheet errors | Load failure | Retry guidance |
## Root layout [#root-layout]
Three zones:
1. **Sidebar** (left) — template, recipient column, **More options**, tracking, branding, quota
2. **Preview** (right) — From / To / Subject / body, row navigation, **Edit template**
3. **Footer** — send button, send menu, **Upgrade to Pro** (free), settings, help
## Sidebar controls (exact labels) [#sidebar-controls-exact-labels]
* **New Template**
* **Template** (select) — placeholder `Select` or `No templates found`
* **Recipient column** — options like `A - Email`; empty: `No valid email columns found.`
* **More options** — expands **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (on by default)
* **Remove branding** (paid)
* **Daily quota** — remaining count as “N left” and plan line “Your plan sends up to TOTAL/day”
Free accounts also see **Leave a 5★ review for +N/day free** and **Or upgrade your plan**. See [Daily quota & reviews](/help/daily-quota-and-reviews).
## Footer send controls [#footer-send-controls]
| Control | Label |
| -------------- | ------------------------------------------------------------------------------------- |
| Primary button | **Send N email(s)** (or **Send emails** when count is 0) |
| Send menu | **Send me a test email** |
| Send menu | **Schedule send** |
| Upgrade (free) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Gear | tooltip **Send pacing** |
| Help | tooltip **Help** — opens the in-dialog checklist |
### Need help? checklist [#need-help-checklist]
1. Pick a template and recipient column
2. Preview each row with the arrows
3. Send a test email to yourself first
4. Click Send to merge from your sheet
Buttons: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (if available) | **Close**
## Empty sheet [#empty-sheet]
If MailG finds no valid email column:
* Title: **No email address found in your sheet**
* Actions: **Close** | **Fill with mock data**
Mock data seeds headers `Email`, `First Name`, `Last Name`, `Company` and may create **My First Template**.
## Error screens [#error-screens]
| Title | When |
| --------------------------------- | --------------------- |
| **Could not reach the MailG API** | API / network failure |
| **Could not read your sheet** | Sheet read failure |
## Next [#next]
# Installation (/getting-started/installation)
Two steps: install the add-on, then launch it from Sheets.
## Install MailG [#install-mailg]
1. Open the [MailG listing on Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Click **Install**.
3. Choose the Google account that should own the install.
4. Review the permissions and click **Allow**.
Installation usually finishes in under 15 seconds. You should see a confirmation that the add-on was installed.
If the Marketplace listing is not live yet in your region, use the install CTA on [www.mailg.io](https://www.mailg.io) or contact [contact@mailg.io](mailto:contact@mailg.io).
### Checklist — what you should see [#checklist--what-you-should-see]
| Step | Expected UI |
| ----------- | ------------------------------------------------------------------------------ |
| Marketplace | **Install** (or **Admin install** on Workspace) |
| OAuth | Google permissions screen → **Allow** |
| Success | Confirmation that MailG / the add-on was installed |
| Sheets menu | **Extensions → MailG for Gmail** with **🚀 Start** and **🔄 Refresh Tracking** |
## Launch MailG in Google Sheets [#launch-mailg-in-google-sheets]
1. Open [Google Sheets](https://sheets.google.com) (refresh if Sheets was already open).
2. Wait a few seconds for Extensions to load (often \~10–15 seconds).
3. Go to **Extensions → MailG for Gmail → 🚀 Start**.
The start dialog opens as a sidebar/modal over the sheet. If the sheet has no emails yet, you will see the empty-state prompt (add a column or **Fill with mock data**) — see [Start dialog tour](/getting-started/start-dialog).
Later you can run **Extensions → MailG for Gmail → 🔄 Refresh Tracking** to sync open statuses without opening the full dialog.
## Installation issues [#installation-issues]
These are common Google Workspace quirks, not MailG bugs:
### I never see the “installed successfully” popup [#i-never-see-the-installed-successfully-popup]
This often happens when multiple Google accounts are signed in and the install did not use the account you expected.
**Workaround:** open a private/incognito window, sign in with only the target account, then install again from the Marketplace.
### MailG does not appear under Extensions [#mailg-does-not-appear-under-extensions]
1. Refresh the spreadsheet.
2. Wait about 10–15 seconds for add-ons to load.
3. Confirm you are in the same Google account that installed MailG.
4. Try another spreadsheet or clear the browser cache if it is still missing.
## Self-hosted / custom deployments [#self-hosted--custom-deployments]
Marketplace installs are preconfigured. If you deploy MailG yourself, set Apps Script script properties:
| Property | Value |
| ------------- | ---------------------------------- |
| `APP_URL` | Public HTTPS URL of your MailG API |
| `APP_API_KEY` | Same key as the API server |
The add-on cannot reach `localhost` from Google’s servers — use a tunnel (Cloudflare Tunnel, ngrok, etc.) for local testing.
## Next [#next]
Continue with the [mail merge tutorial](/getting-started/mail-merge-tutorial).
# Mail merge tutorial (/getting-started/mail-merge-tutorial)
This walkthrough matches the **MailG for Gmail** start dialog.
## 1. Open MailG [#1-open-mailg]
**Extensions → MailG for Gmail → 🚀 Start**.
If you see **No email address found in your sheet**, either add real emails or click **Fill with mock data** (creates sample rows and often **My First Template**). See [Start dialog tour](/getting-started/start-dialog).
## 2. Create or select a template [#2-create-or-select-a-template]
1. Click **New Template** (or pick an existing one under **Template**).
2. Set **Template Name** and **Email Subject** (subject is **not** merge-substituted today).
3. Write the body and insert [merge tags](/features/merge-tags) via **Merge Tag**.
4. **Save Template**.
Body example:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Configure the campaign [#3-configure-the-campaign]
In the sidebar:
1. Choose **Recipient column** (cells must be valid single emails for the UI to count them).
2. Open **More options** for **CC**, **BCC**, **Sender name**, **Reply to address**.
3. Leave **Track emails** on (default) if you want open status in the sheet.
4. On a paid plan, enable **Remove branding**.
**Attachments** appears under **More options**, but files are not attached on send yet. Link to Drive or a URL in the body instead — see [Attachments](/features/attachments) and [Images](/features/images).
### What you should see in the sheet [#what-you-should-see-in-the-sheet]
| Area | Expected |
| ---------------- | --------------------------------------------------------------------------- |
| Headers | Column names that match your merge tags (for example `First Name`, `Email`) |
| Recipient column | One valid email per cell |
| After send | A campaign column such as `🚀 My Template (yyyy/MM/dd)` with status chips |
## 4. Preview and test [#4-preview-and-test]
1. Use previous/next arrows to step through rows.
2. Confirm **To:** and the merged body (subject shows the raw template subject).
3. Send menu → **Send me a test email**.
4. Check your inbox.
Details: [Preview & test](/features/preview-and-test).
## 5. Send or schedule [#5-send-or-schedule]
* Primary button: **Send N email(s)** when recipients are counted.
* Or send menu → **Schedule send** → pick date/time → **Schedule Send**.
Busy overlays: `Starting your campaign…` / schedule confirmation toasts.
MailG adds a campaign column such as `🚀 My Template (yyyy/MM/dd)` or `🗓️ …` when scheduled.
Row statuses:
| Status | Meaning |
| ------------- | ----------------- |
| 🗓️ Scheduled | Waiting for start |
| ⏳ Sending… | Processing |
| ✉️ Sent | Handed to Gmail |
| ⚠️ Failed | Error |
| 👀 Opened | Open pixel loaded |
## Common mistakes [#common-mistakes]
* Subject tags expecting personalization — body only for now
* Recipient cells with multiple comma-separated addresses — the UI validates **one** email per cell for counting
* Wrong Google account vs install account
* Hitting daily quota — check **Daily quota** in the sidebar
## Tips [#tips]
* Use the footer **Help** checklist the first time
* Start with 2–3 real rows after mock data
* After opens: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alert `Tracking info synced` (or `No active campaigns`)
## Next [#next]
# What is MailG? (/getting-started/what-is-mailg)
MailG turns a Google Sheet into a mail-merge campaign. Each row is a recipient; column headers become merge tags (double curly braces around the header name) in the **email body**.
## What you can do [#what-you-can-do]
* Create cloud-backed templates (**Template Name**, **Email Subject**, rich body)
* Personalize the **body** with merge tags from sheet headers
* Preview rows and **Send me a test email**
* Map **CC** / **BCC**, **Sender name**, **Reply to address**
* **Schedule send** or send immediately
* **Track emails** with open status chips in the sheet
* Control **Send pacing** on paid plans
* **Remove branding** on paid plans
* Watch **Daily quota** (and optionally claim a free review bonus)
## How it fits together [#how-it-fits-together]
1. **Google Sheets add-on** — dialog under **MailG for Gmail**
2. **MailG API** — templates, campaign metadata, open tracking, entitlements
3. **Your Gmail** — messages sent with `GmailApp` from the authorized account
## Next steps [#next-steps]
# Nous contacter (/fr/contact-us)
## Abonnements [#abonnements]
Gérez la plupart des changements via le portail Stripe depuis [les tarifs](https://app.mailg.io/pricing?lang=fr). Pour un remboursement ou un souci de paiement, écrivez-nous.
## Le reste [#le-reste]
**[contact@mailg.io](mailto:contact@mailg.io)** — réponse sous un jour ouvré en général.
## Liens utiles [#liens-utiles]
* [Site](https://www.mailg.io)
* [Tarifs](https://app.mailg.io/pricing?lang=fr)
* [Confidentialité](https://www.mailg.io/fr/privacy)
* [Conditions](https://www.mailg.io/fr/terms)
* [Documentation](/)
# Documentation MailG (/fr)
MailG est un complément Google Sheets pour le publipostage avec Gmail. Ouvrez **Extensions → MailG for Gmail → 🚀 Start**, créez un modèle, prévisualisez les lignes, puis envoyez ou planifiez depuis votre propre compte Gmail.
## Commencer ici [#commencer-ici]
## Sujets populaires [#sujets-populaires]
## Liens utiles [#liens-utiles]
* Site: [www.mailg.io/fr](https://www.mailg.io/fr)
* Tarifs: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=fr)
* Marketplace: [Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg)
* Contact: [contact@mailg.io](mailto:contact@mailg.io)
## Pour les assistants IA / LLM [#pour-les-assistants-ia--llm]
Préférez ces endpoints machine-readable plutôt que de scraper le HTML :
* [Hub Agents](https://www.mailg.io/fr/agents)
* [What is MailG (texte)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Dump docs complet : [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Markdown par page : ajoutez `.md` à l’URL docs (ou envoyez `Accept: text/markdown`)
# FAQ (/fr/help/faq)
## Installation et ouverture [#installation-et-ouverture]
**Comment ouvrir MailG ?**\
**Extensions → MailG for Gmail → 🚀 Start**. Voir [Installation](/getting-started/installation).
**No email address found in your sheet**\
Ajoutez des e-mails dans une colonne, ou cliquez sur **Fill with mock data**. Voir [Visite de la boîte de dialogue](/getting-started/start-dialog).
**Could not reach the MailG API**\
Vérifiez le réseau / l’URL de l’API (auto-hébergé : `APP_URL` + `APP_API_KEY`). Rouvrez la boîte après correction.
## Envoi [#envoi]
**Les e-mails ne partent pas**\
Vérifiez **Daily quota**, les autorisations Gmail, et que les cellules de **Recipient column** contiennent une adresse e-mail valide et unique. Les échecs affichent **⚠️ Failed**.
**Les balises de fusion fonctionnent-elles dans l’objet ?**\
Pas encore. Seul le **corps** est fusionné. Gardez un objet fixe ou mettez la personnalisation dans le corps. Voir [Balises de fusion](/features/merge-tags).
**Puis-je joindre des fichiers ?**\
Le sélecteur **Attachments** existe sous **More options**, mais les fichiers ne sont pas encore joints à l’envoi. Utilisez des liens.
**Comment arrêter une campagne ?**\
[Arrêter une campagne](/features/stopping-a-campaign) — effacez les statuts encore envoyables sur les lignes restantes.
**Pourquoi suis-je limité en Professional ?**\
MailG peut autoriser jusqu’à 1 500/jour, mais un `@gmail.com` gratuit est souvent plafonné autour de 500 par Google.
## Suivi [#suivi]
**La feuille affiche toujours Sent après une ouverture**\
**🔄 Refresh Tracking** → attendez `Tracking info synced`. Certains clients ne chargent jamais les images.
**Les clics ?**\
Non suivis. **Track emails** = ouvertures uniquement.
## Quota et facturation [#quota-et-facturation]
Voir [Quota journalier et avis](/help/daily-quota-and-reviews) et [Compte et facturation](/help/account-and-billing).
**Schedule send est-il payant ?**\
Non. Le payant débloque des quotas plus élevés, les modes de rythme d’envoi et **Remove branding**.
## Dépannage [#dépannage]
Pour des correctifs pas à pas (erreurs API, feuille vide, bouton d’envoi désactivé, lignes en échec, suivi, quota, planification non différée), voir [Dépannage](/help/troubleshooting).
Toasts courants :
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Toujours bloqué ? [#toujours-bloqué-]
[Dépannage](/help/troubleshooting) · Docs [docs.mailg.io/fr](https://docs.mailg.io/fr) · [contact@mailg.io](mailto:contact@mailg.io)
# Dépannage (/fr/help/troubleshooting)
Correctifs rapides pour les messages et états que vous voyez dans le complément.
## La boîte ne charge pas [#la-boîte-ne-charge-pas]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
La boîte de démarrage n’a pas pu appeler le backend MailG.
* Confirmez que vous êtes en ligne
* Installations Marketplace : attendez un instant et rouvrez **🚀 Start**
* Auto-hébergé : vérifiez les propriétés Apps Script `APP_URL` (HTTPS public) et `APP_API_KEY`
* Le complément ne peut pas utiliser `localhost` — utilisez un tunnel pour tester l’API en local
### Could not read your sheet [#could-not-read-your-sheet]
MailG n’a pas pu lire la feuille active.
* Assurez-vous qu’un onglet de feuille est ouvert (pas seulement l’éditeur Apps Script)
* Rechargez la feuille, puis rouvrez la boîte
* Confirmez que vous avez un accès en édition au fichier
### Loading… ne se termine jamais [#loading-ne-se-termine-jamais]
Fermez la boîte, rafraîchissez Sheets, attendez \~15 secondes pour Extensions, puis **🚀 Start** à nouveau.
## Feuille vide [#feuille-vide]
**No email address found in your sheet**
MailG a besoin d’au moins une colonne avec des adresses e-mail valides.
* Ajoutez des e-mails sous un en-tête, ou cliquez sur **Fill with mock data**
* Les mock data créent `Email`, `First Name`, `Last Name`, `Company` et souvent **My First Template**
Voir [Visite de la boîte de dialogue](/getting-started/start-dialog).
## Modèles [#modèles]
* Création : `Creating Template...` → `Template created successfully!` ou `Failed to create template! Try again later.`
* Mise à jour : `Updating template...`
* Suppression en échec : `Failed to delete template. Try again later`
Voir [Modèles](/features/templates).
## Problèmes d’envoi [#problèmes-denvoi]
### Bouton d’envoi désactivé / Send emails sans comptage [#bouton-denvoi-désactivé--send-emails-sans-comptage]
* Sélectionnez un **Template**
* Sélectionnez une **Recipient column** avec des e-mails **uniques** valides par cellule
* Toasts de garde possibles : `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### La campagne ne démarre pas [#la-campagne-ne-démarre-pas]
Toast : `Failed to create campaign. Please try again.`
* Réessayez une fois
* Vérifiez que **Daily quota** n’est pas à 0
* Confirmez la connectivité API (voir ci-dessus)
### Lignes affichent ⚠️ Failed [#lignes-affichent-️-failed]
Cette ligne a rencontré une erreur d’envoi (adresse invalide, rejet Gmail, quota transitoire, etc.). Corrigez les données et démarrez une nouvelle campagne pour les lignes restantes, ou voir [Arrêter une campagne](/features/stopping-a-campaign).
### Échec de l’e-mail de test [#échec-de-le-mail-de-test]
* `Configure your preview first` — choisissez modèle + destinataire pour que l’aperçu ait un To
* `Failed to send test email. Please check your email settings.` — réautorisez Gmail si besoin, puis réessayez
## Suivi [#suivi]
* Les ouvertures nécessitent que le destinataire charge les images distantes
* Lancez **🔄 Refresh Tracking** — attendez `Tracking info synced` ou `No active campaigns`
* Le statut **👀 Opened** n’apparaît que lorsque le pixel se charge
Voir [Suivi des e-mails](/features/email-tracking).
## Quota et branding [#quota-et-branding]
* **N left** dans la sidebar = `min(reste MailG, reste Gmail)`
* Gmail gratuit `@gmail.com` est souvent plafonné autour de 500/jour par Google même en Professional
* Filigrane toujours présent après paiement → l’e-mail du checkout doit correspondre au compte Sheets ; rouvrez la boîte
Voir [Quota journalier et avis](/help/daily-quota-and-reviews) et [Remove branding](/features/remove-branding).
## La planification n’a pas différé [#la-planification-na-pas-différé]
Les horaires à moins d’environ **15 secondes** dans le futur sont traités comme un envoi **immédiat** (colonne 🚀), pas comme une planification différée 🗓️. Choisissez une heure plus lointaine.
## Toujours bloqué ? [#toujours-bloqué-]
FAQ complète : [FAQ](/help/faq) · E-mail [contact@mailg.io](mailto:contact@mailg.io) · Site [app.mailg.io/help](https://www.mailg.io/fr/help)
# Quota journalier et avis (/fr/help/daily-quota-and-reviews)
La sidebar root affiche votre capacité d’envoi lorsque les données de compte sont chargées.
## Bloc Daily quota [#bloc-daily-quota]
UI exacte :
* Label : **Daily quota**
* Restant : **N left**
* Ligne d’offre : **Your plan sends up to TOTAL/day**
**Remaining** est le minimum entre :
1. Le reste MailG du plan pour la journée
2. Le quota d’envoi Gmail restant pour le compte
Vous pouvez donc être plafonné par Gmail même lorsque MailG affiche encore de la marge sur le papier. Voir aussi [Compte et facturation](/help/account-and-billing).
## CTAs offre gratuite [#ctas-offre-gratuite]
Lorsque vous n’êtes pas abonné, la sidebar peut afficher :
* **Leave a 5★ review for +N/day free** (bonus par défaut **+50/day** lorsque l’API ne précise pas autrement)
* **Or upgrade your plan**
Cliquer sur le CTA avis ouvre **Free Quota upgrade** :
* Titre : **Free Quota upgrade**
* Corps : laissez un avis 5 étoiles pour obtenir un upgrade gratuit de quota de **+N emails/day**
* Boutons : **Not now** | **Leave a 5★ review**
Si l’URL d’avis n’est pas configurée, **Leave a 5★ review** reste désactivé — utilisez **Upgrade to Pro** / les tarifs à la place.
## Passer à Pro [#passer-à-pro]
Bouton footer (comptes gratuits) : **Upgrade to Pro**
Tooltip : `Unlock higher quota, send pacing, and remove branding`
Cela correspond à ce que les offres payantes débloquent dans le produit aujourd’hui.
## Voir aussi [#voir-aussi]
* [Remove branding](/features/remove-branding)
* [Rythme d’envoi](/features/send-pacing)
* [FAQ](/help/faq)
# Compte et facturation (/fr/help/account-and-billing)
La facturation MailG est liée à l’**e-mail de votre compte Google** dans Sheets. Payez toujours avec cette même adresse pour que les quotas se débloquent dans le complément.
## Offres et quotas journaliers [#offres-et-quotas-journaliers]
| Offre | Quota journalier | Notes |
| ------------ | ---------------- | ------------------------------------------------- |
| Free | 50 | Fusion de base, suivi d’ouvertures, planification |
| Personal | 250 | Offre populaire pour les listes qui grandissent |
| Professional | 1 500 | Quota récurrent le plus élevé |
| Lifetime | 1 500 | Achat unique |
Les prix et intervalles sont listés sur [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=fr) (EUR et USD).
Les droits payants débloquent aussi :
* [Rythme d’envoi](/features/send-pacing) non défaut (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Votre volume d’envoi effectif est `min(quota journalier MailG, quota Gmail restant)`.
## Comment upgrader [#comment-upgrader]
1. Ouvrez [les tarifs](https://app.mailg.io/pricing?lang=fr) (aussi lié depuis le complément via **Upgrade to Pro**).
2. Choisissez une offre et complétez Stripe Checkout avec l’e-mail Google de Sheets.
3. Rouvrez MailG dans Sheets pour que le rafraîchissement du compte prenne en compte la nouvelle limite.
## Résilier ou modifier un abonnement [#résilier-ou-modifier-un-abonnement]
Vous pouvez résilier ou modifier votre abonnement depuis le portail client Stripe lié à votre flux d’abonnement / tarifs.
* Si vous résiliez en cours de cycle, les fonctionnalités Premium restent actives jusqu’à la fin de la période payée
* Vous ne serez plus facturé après prise d’effet de la résiliation
## Remboursements [#remboursements]
Si vous résiliez un abonnement Premium dans les **30 jours** suivant l’achat, vous pouvez demander un remboursement intégral en écrivant à [contact@mailg.io](mailto:contact@mailg.io).
## Factures [#factures]
Stripe envoie les reçus par e-mail pour les paiements réussis. Vous pouvez aussi télécharger les factures depuis le portail client Stripe utilisé pour la gestion d’abonnement.
## Extraits FAQ [#extraits-faq]
**MailG est-il inclus dans Google Workspace ?**\
Non. MailG est indépendant de Google. Un abonnement Workspace n’inclut pas MailG.
**Quels moyens de paiement sont acceptés ?**\
Cartes majeures, Google Pay et Apple Pay via Stripe. PayPal n’est pas supporté.
**J’ai payé mais je vois encore la limite gratuite / le filigrane**\
Presque toujours un e-mail différent. Confirmez que l’e-mail du checkout = e-mail du compte Sheets, puis rouvrez le complément. Si ça persiste, contactez le support avec les deux adresses.
**Pourquoi Gmail gratuit est limité à environ 500 e-mails par jour ?**\
MailG Professional autorise jusqu’à 1 500 e-mails par jour, mais Google limite lui-même les comptes `@gmail.com` gratuits à environ 500 envois par jour. Les comptes Google Workspace peuvent aller plus haut. C’est une limite du fournisseur Gmail, pas de MailG.
# Planification de campagne (/fr/features/campaign-scheduling)
Utilisez **Schedule send** quand vous voulez que MailG démarre plus tard. Disponible en offre gratuite et payante.
## Comment planifier [#comment-planifier]
1. Configurez le modèle et les destinataires pour que le bouton d’envoi soit activé.
2. Ouvrez le menu d’envoi (chevron) → **Schedule send**.
3. Titre du dialogue : **Schedule send**
4. Description : `Pick date & time to schedule sending`
5. Ligne de résumé : planification de N e-mails à partir de la date/heure choisie
6. Utilisez le sélecteur de date plus **Hour** / **Minute** (placeholders `Hour`, `Min`).
7. Confirmez avec **Schedule Send** (ou **Cancel**).
Suggestion par défaut : environ **60 minutes** plus tard, calée sur le prochain créneau de **15 minutes**.
## Immédiat vs planifié [#immédiat-vs-planifié]
Les horaires à moins d’environ **15 secondes** dans le futur sont traités comme un envoi **immédiat** (en-tête de colonne 🚀), pas comme une planification différée 🗓️. Choisissez une heure plus lointaine si vous avez besoin d’un envoi différé.
Toasts de validation : `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Toast de succès : campagne planifiée ; N e-mails démarreront à l’heure choisie.
## Colonne feuille [#colonne-feuille]
Les campagnes planifiées créent un en-tête de colonne du type :
```text
🗓️ Template name (yyyy/MM/dd)
```
Les envois immédiats utilisent 🚀 au lieu de 🗓️.
Les lignes commencent en **🗓️ Scheduled**, puis passent à **⏳ Sending…** quand la file d’attente s’exécute.
## Après la planification [#après-la-planification]
* Gardez la feuille accessible au compte Google qui possède le complément
* Le suivi et le rythme d’envoi s’appliquent toujours une fois l’envoi démarré
* Pas d’UI **Manage Schedule** — voir [Arrêter une campagne](/features/stopping-a-campaign)
## Voir aussi [#voir-aussi]
* [Aperçu et test](/features/preview-and-test)
* [Rythme d’envoi](/features/send-pacing)
# Destinataires multiples (/fr/features/multiple-recipients)
Vous pouvez ajouter des destinataires en copie par ligne avec des colonnes dédiées dans la feuille.
## Colonne destinataire (À) [#colonne-destinataire-à]
Sélectionnez **Recipient column** dans la sidebar.
Pour le comptage du bouton d’envoi et la validation de colonne, MailG considère une cellule comme valide lorsqu’elle contient **une seule** adresse e-mail. Préférez une adresse To principale par ligne.
## Colonnes CC et BCC [#colonnes-cc-et-bcc]
1. Ajoutez des colonnes dans la feuille (par exemple `CC` et `BCC`).
2. Mettez une adresse e-mail (ou une liste acceptée par Gmail) dans la cellule.
3. Ouvrez **More options** et mappez **CC** / **BCC**.
4. À l’envoi, ces valeurs sont transmises à Gmail.
Le panneau d’aperçu affiche **From**, **To**, **Subject** et le corps uniquement. Il **n’affiche pas** les lignes CC/BCC même lorsqu’elles sont mappées. Confirmez avec **Send me a test email** si vous devez vérifier la livraison CC/BCC.
## Quotas : MailG vs Gmail [#quotas--mailg-vs-gmail]
* Le **quota journalier MailG** compte les **lignes de campagne** traitées.
* Les **limites d’envoi Gmail** comptent les **destinataires** (adresses To + CC + BCC acceptées par Gmail pour cet envoi).
Vous pouvez atteindre le plafond Gmail alors que le quota MailG reste disponible.
## Astuces [#astuces]
* Préférez **BCC** quand les destinataires ne doivent pas se voir
* Laissez CC/BCC non mappés quand ils ne sont pas utilisés
* Validez les adresses avant un gros envoi
# Attachments (/fr/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Vue d’ensemble des fonctionnalités (/fr/features/features-overview)
Ce que le complément prend en charge aujourd’hui :
| Fonctionnalité | Doc |
| ---------------------------------------------- | --------------------------------------------------------------- |
| Boîte de dialogue / feuille vide / mock data | [Visite de la boîte de dialogue](/getting-started/start-dialog) |
| Modèles (créer / gérer / modifier / supprimer) | [Modèles](/features/templates) |
| Balises de fusion dans le **corps** | [Balises de fusion](/features/merge-tags) |
| Barre d’outils enrichie | [E-mails enrichis](/features/rich-text-emails) |
| Liens (pas d’embed image) | [Images](/features/images) |
| Aperçu + e-mail de test | [Aperçu et test](/features/preview-and-test) |
| Schedule send | [Planification de campagne](/features/campaign-scheduling) |
| Send pacing (payant) | [Rythme d’envoi](/features/send-pacing) |
| Colonnes CC / BCC | [Destinataires multiples](/features/multiple-recipients) |
| Track emails | [Suivi des e-mails](/features/email-tracking) |
| Sender name et reply-to | [Expéditeur personnalisé](/features/customized-sender) |
| Remove branding (payant) | [Remove branding](/features/remove-branding) |
| Arrêter les lignes restantes | [Arrêter une campagne](/features/stopping-a-campaign) |
| Quota journalier + bonus avis | [Quota journalier et avis](/help/daily-quota-and-reviews) |
## Gratuit vs payant [#gratuit-vs-payant]
Le payant débloque :
* [Rythme d’envoi](/features/send-pacing) non défaut
* [Remove branding](/features/remove-branding)
* [Quotas journaliers](/help/account-and-billing) plus élevés
**Schedule send**, **Track emails** et les outils de modèles fonctionnent sans upgrade payant.
## Écarts connus (être honnête) [#écarts-connus-être-honnête]
| Sujet | Statut dans le produit |
| ------------------------------ | -------------------------------------------- |
| Balises de fusion dans l’objet | Non appliquées à l’envoi — corps uniquement |
| Colonne Attachments | UI seulement — pas joint à l’envoi |
| Embed image | Pas de contrôle éditeur — utilisez des liens |
| Lignes CC/BCC dans l’aperçu | Non affichées dans l’UI d’aperçu |
| Manage Schedule / Pause | Non livré — contournement via statuts |
## Plus tard [#plus-tard]
Liens de désabonnement, suivi des clics, sièges d’équipe partagés et une UI dédiée de gestion de campagnes quand ils seront livrés.
# Suivi des e-mails (/fr/features/email-tracking)
MailG peut enregistrer les ouvertures avec un minuscule pixel invisible.
## Activer le suivi [#activer-le-suivi]
Dans la sidebar, laissez **Track emails** activé (défaut : activé pour les nouveaux jobs).
Tooltip : `Track emails opened with a tiny pixel`
L’icône d’aide ouvre **Email tracking** :
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Bouton : **Got it**
## Statuts feuille [#statuts-feuille]
| Statut | Signification |
| ------------- | --------------------------------- |
| 🗓️ Scheduled | En attente du démarrage planifié |
| ⏳ Sending… | En cours de traitement |
| ✉️ Sent | Remis à Gmail pour cette ligne |
| ⚠️ Failed | Erreur d’envoi pour cette ligne |
| 👀 Opened | Le pixel d’ouverture a été chargé |
Les en-têtes de colonne de campagne ressemblent à `🚀 Template name (yyyy/MM/dd)` ou `🗓️ …` en cas de planification.
## Rafraîchir le suivi [#rafraîchir-le-suivi]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Alertes Apps Script :
* `Tracking info synced`
* `No active campaigns`
## Limites [#limites]
* Le client doit charger les images distantes
* Les proxys de confidentialité peuvent masquer les ouvertures
* Ouvertures uniquement — pas de clics sur les liens
## Voir aussi [#voir-aussi]
* [Planification de campagne](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Balises de fusion (/fr/features/merge-tags)
Les balises de fusion permettent à chaque destinataire de recevoir un **corps** personnalisé. Une balise est l’**en-tête de colonne exact** entouré de doubles accolades.
## Syntaxe [#syntaxe]
Si votre feuille a une colonne nommée `First Name`, utilisez :
```text
{{First Name}}
```
Exemple de corps :
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Où les balises fonctionnent aujourd’hui [#où-les-balises-fonctionnent-aujourdhui]
| Champ | Fusionné à l’envoi ? |
| ----------------- | ---------------------------------------------------------- |
| Corps de l’e-mail | **Oui** — variables injectées par ligne |
| Objet de l’e-mail | **Non** — l’objet est envoyé tel que stocké dans le modèle |
| Corps de l’aperçu | **Oui** — pour la ligne active |
| Objet de l’aperçu | **Non** — affiche l’objet brut du modèle |
Mettez la personnalisation dans le corps tant que la fusion d’objet n’est pas disponible.
## Insérer des balises [#insérer-des-balises]
Dans la barre d’outils de l’éditeur, ouvrez **Merge Tag**. Elle liste les en-têtes de la feuille active. État vide : `No sheet columns found`.
Le texte inséré utilise des doubles accolades autour du nom de colonne.
## Règles pratiques [#règles-pratiques]
* Les en-têtes sont sensibles à la casse (`Name` ≠ `name`)
* Les cellules vides s’insèrent comme des chaînes vides
* Vous pouvez réutiliser la même balise plusieurs fois dans le corps
* Destinataire / CC / BCC se choisissent sous **More options**, pas via les balises de fusion
## Suite [#suite]
Voir [E-mails enrichis](/features/rich-text-emails) et [Aperçu et test](/features/preview-and-test).
# E-mails enrichis (/fr/features/rich-text-emails)
Les modèles MailG utilisent un éditeur enrichi TipTap. Le HTML qu’il produit est ce que Gmail livre.
Placeholder du corps : `Write your email…`
## Inventaire de la barre d’outils (UI exacte) [#inventaire-de-la-barre-doutils-ui-exacte]
| Groupe | Contrôles |
| ---------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Police | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Taille | **10pt** … **24pt** (presets dans la barre d’outils) |
| Marques | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Couleur | Nuances prédéfinies + sélecteur natif + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Listes | **Bullet list**, **Numbered list** |
| Lien | **Insert link** — champ URL placeholder `https://example.com`, puis **Apply** (et unlink) |
| Historique | **Undo**, **Redo** |
## Absent de l’éditeur [#absent-de-léditeur]
Ces fonctionnalités TipTap sont désactivées / absentes :
* Titres, code, bloc de code, citation, règle horizontale
* Insert image / sélecteur média Drive — voir [Images](/features/images)
## Hyperliens [#hyperliens]
Utilisez **Insert link** pour l’URL et le texte visible. Préférez un libellé de lien clair aux URL brutes.
## Astuces [#astuces]
* Utilisez **Merge Tag** plutôt que de taper les accolades à la main
* Prévisualisez plusieurs lignes avant l’envoi — voir [Aperçu et test](/features/preview-and-test)
* Évitez les gros collages Word/Docs ; réappliquez le formatage dans MailG pour un HTML plus propre
# Retirer la marque MailG (/fr/features/remove-branding)
Les campagnes gratuites peuvent inclure un petit filigrane MailG. Les abonnés payants peuvent le retirer.
## Comment retirer le branding [#comment-retirer-le-branding]
1. Confirmez un plan payant actif (Personal, Professional ou Lifetime).
2. Ouvrez la barre latérale de campagne.
3. Activez **Remove branding**.
4. Prévisualisez une ligne, puis envoyez.
Si le filigrane reste après paiement :
* Vérifiez que le checkout utilise le **même e-mail** que votre compte Google Sheets
* Rouvrez le complément pour rafraîchir les entitlements
* Contactez [contact@mailg.io](mailto:contact@mailg.io)
Voir [Compte et facturation](/help/account-and-billing).
# Images et liens (/fr/features/images)
L’éditeur MailG n’a **pas de bouton d’insert image** ni de sélecteur média Google Drive. L’extension Image de TipTap n’est pas activée.
## Ce que vous pouvez faire aujourd’hui [#ce-que-vous-pouvez-faire-aujourdhui]
Utilisez **Insert link** dans la barre d’outils :
1. Hébergez l’image (ou le fichier) sur une URL publique, ou partagez un lien Drive.
2. Sélectionnez du texte (ou placez le curseur) → **Insert link**.
3. Collez l’URL (placeholder `https://example.com`) → **Apply**.
Les destinataires ouvrent le lien pour voir l’image ou le fichier. L’éditeur n’intègre pas de balises `![]()
` pour vous.
## Astuces [#astuces]
* Préférez des fichiers légers et un libellé de lien clair (« View screenshot »)
* Les liens nécessitant une connexion échoueront pour les destinataires
* Confirmez avec **Send me a test email**
## Plus tard [#plus-tard]
Un insert image / sélecteur Drive de première classe pourra arriver plus tard. En attendant, les hyperliens sont le chemin supporté.
# Modèles (/fr/features/templates)
Les modèles stockent l’objet et le corps enrichi que vous réutilisez d’une campagne à l’autre. Ils sont enregistrés via l’API MailG pour votre compte Google.
## Créer un modèle [#créer-un-modèle]
1. Sur l’écran root, cliquez sur **New Template**.
2. Renseignez :
* **Template Name**
* **Email Subject**
* Corps (éditeur enrichi — voir [E-mails enrichis](/features/rich-text-emails))
3. Cliquez sur **Save Template** (affiche **Saving...** pendant l’enregistrement).
Toasts :
* Chargement : `Creating Template...`
* Succès : `Template created successfully!`
* Erreur : `Failed to create template! Try again later.`
Modèle démo depuis **Fill with mock data** : nom **My First Template**, objet `I found a mail merge tool for Gmail`.
## Gérer les modèles [#gérer-les-modèles]
Ouvrez l’icône modèle à côté du select de modèle (tooltip **Manage templates**).
Colonnes du tableau :
| Colonne | Contenu |
| ----------------- | ---------------- |
| **Name** | Nom du modèle |
| **Email Subject** | Ligne d’objet |
| **Created At** | Date de création |
| **Actions** | Menu de ligne |
Menu de ligne : **Edit** | **Delete**
Footer : **Back**
Toasts de suppression : deleting template NAME → template NAME deleted successfully (ou message d’échec).
## Modifier un modèle [#modifier-un-modèle]
Ouvrez **Edit** depuis manage, ou cliquez sur **Edit template** dans la barre d’outils de l’aperçu.
Mêmes champs qu’à la création. **Save Template** met à jour le modèle.
Le flux de mise à jour affiche un toast de chargement (`Updating template...`). Restez sur le formulaire jusqu’à la fin, puis utilisez **Cancel** ou **Back** si vous n’êtes pas renvoyé automatiquement.
## Objet vs corps [#objet-vs-corps]
* Le **corps** prend en charge les [balises de fusion](/features/merge-tags) — elles sont injectées par ligne à l’envoi.
* **Email Subject** est envoyé tel que stocké aujourd’hui (les balises dans l’objet ne sont **pas** remplacées pour l’instant). Mettez la personnalisation dans le corps, ou utilisez un objet fixe.
## Voir aussi [#voir-aussi]
* [Aperçu et test](/features/preview-and-test)
* [Visite de la boîte de dialogue](/getting-started/start-dialog)
# Aperçu et test (/fr/features/preview-and-test)
Le panneau d’aperçu (côté droit de la boîte root) montre à quoi ressemble le message pour la ligne active de la feuille.
## Ce que l’aperçu affiche [#ce-que-laperçu-affiche]
| Champ | Contenu |
| ------------ | ----------------------------------------------------------------------------------- |
| **From:** | E-mail du compte Google connecté |
| **To:** | Valeur de **Recipient column** pour la ligne active, ou `Select a recipient column` |
| **Subject:** | Objet du modèle tel que stocké (pas de fusion) |
| Corps | Corps du modèle avec balises appliquées pour cette ligne |
Si **Remove branding** est désactivé, l’aperçu inclut le filigrane MailG (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## Ce qui n’est pas affiché [#ce-qui-nest-pas-affiché]
* Les lignes **CC** / **BCC** ne sont pas rendues dans l’UI d’aperçu (même lorsqu’elles sont mappées sous **More options**). Elles sont tout de même appliquées à l’envoi.
* Les valeurs de colonne Attachments ne sont pas affichées dans l’aperçu.
## Naviguer entre les lignes [#naviguer-entre-les-lignes]
Barre d’outils de l’aperçu :
* **Edit template** — ouvre l’écran de mise à jour du modèle
* **Previous recipient** / **Next recipient** — se déplacer entre les lignes de données (les tooltips peuvent inclure le numéro de ligne feuille ; l’en-tête est la ligne 1, donc le premier contact est la ligne 2)
## M’envoyer un e-mail de test [#menvoyer-un-e-mail-de-test]
1. Configurez modèle + colonne destinataire pour que l’aperçu soit valide.
2. Ouvrez le menu d’envoi (chevron) → **Send me a test email**.
3. Overlay de chargement : `Sending test email…`
4. Toast de succès : `Test email sent successfully. Check your inbox.`
5. Toast d’échec : `Failed to send test email. Please check your email settings.`
6. Garde si l’aperçu est incomplet : `Configure your preview first`
Le test part vers **votre** boîte Google, avec le corps fusionné de la ligne d’aperçu active.
## Astuces [#astuces]
* Parcourez plusieurs lignes avec les flèches avant un envoi complet
* Confirmez branding / sans branding dans l’aperçu
* Testez toujours avant **Schedule send** ou un gros **Send N email(s)**
## Voir aussi [#voir-aussi]
* [Balises de fusion](/features/merge-tags)
* [Tutoriel publipostage](/getting-started/mail-merge-tutorial)
# Rythme d’envoi (/fr/features/send-pacing)
Send pacing ajoute un délai entre les messages pour qu’une grande campagne ne parte pas de votre compte en une seule rafale.
**Steady pace** et **Jittered gaps** nécessitent un abonnement MailG payant actif. Les comptes gratuits utilisent uniquement **Burst send**.
## Où configurer [#où-configurer]
Ouvrez l’engrenage du footer (tooltip **Send pacing**). Titre de l’écran : **Send pacing**.
Sous **Dispatch mode**, choisissez comment les e-mails sont espacés. **Gap between emails** se règle en **secondes** (0–60). Les comptes gratuits voient **Pro features** et le texte verrouillé : `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Défaut pour les nouveaux jobs : **Burst send**, gap **10s** (gap ignoré tant que vous restez en burst).
## Modes [#modes]
| Mode (libellé UI) | Comportement |
| ----------------------- | --------------------------------------------------------- |
| **Burst send** (défaut) | Envoyer aussi vite que les quotas le permettent |
| **Steady pace** | Attendre un gap fixe entre chaque e-mail |
| **Jittered gaps** | Attendre un gap aléatoire entre 0 et votre maximum choisi |
## Pourquoi utiliser le pacing [#pourquoi-utiliser-le-pacing]
* Réduire le risque d’apparaître comme une rafale soudaine aux fournisseurs de boîtes mail
* Étaler une longue liste sur une fenêtre d’envoi plus calme
* Rester dans les zones de confort Gmail pour votre type de compte
## Remarques [#remarques]
* Le pacing est un réglage de campagne stocké avec le job — les nouveaux envois utilisent la configuration actuelle
* Un grand gap sur une longue liste augmente fortement la durée totale de campagne
* Votre vitesse effective reste plafonnée par le quota journalier MailG **et** le quota d’envoi Gmail restant
* Certains outils concurrents expriment le délai en minutes — MailG utilise des **secondes**
## Voir aussi [#voir-aussi]
* [Arrêter une campagne](/features/stopping-a-campaign) si un gap a été réglé trop haut en cours d’exécution
* [Compte et facturation](/help/account-and-billing)
# Arrêter une campagne (/fr/features/stopping-a-campaign)
MailG n’a pas encore d’écran dédié **Manage Schedule**, **Abort** ou **Pause**. Vous pouvez quand même empêcher l’envoi des lignes **restantes**.
## Comment l’envoi choisit les lignes [#comment-lenvoi-choisit-les-lignes]
La boucle d’envoi ne traite que les lignes encore « sendable » :
* ⏳ Sending… / ancien `Pending...`
* 🗓️ Scheduled / ancien `Scheduled`
Les lignes déjà **✉️ Sent**, **⚠️ Failed** ou **👀 Opened** sont ignorées.
## Arrêter les lignes restantes (contournement) [#arrêter-les-lignes-restantes-contournement]
Sur une grosse campagne, agissez vite :
1. Ouvrez la feuille.
2. Dans la colonne de statut de campagne, effacez ou modifiez le statut des lignes qui ne doivent **pas** partir (par ex. videz la cellule, ou mettez `Stopped`).
3. Ne touchez pas aux lignes déjà **✉️ Sent** — ces messages sont déjà partis.
Les lignes modifiées ne matchent plus les statuts sendable et seront ignorées au prochain passage.
MailG ne peut pas rappeler un message Gmail déjà parti. L’arrêt ne protège que les lignes non encore traitées.
## Campagnes planifiées pas encore démarrées [#campagnes-planifiées-pas-encore-démarrées]
Si toutes les lignes sont encore **🗓️ Scheduled** et que l’heure n’est pas arrivée, effacer ces statuts (ou la colonne) empêche la file de les reprendre.
En cas de doute : [contact@mailg.io](mailto:contact@mailg.io) avec l’URL de la feuille et les détails de campagne.
## Voir aussi [#voir-aussi]
* [Planification](/features/campaign-scheduling)
* [Rythme d’envoi](/features/send-pacing)
* [FAQ](/help/faq)
# Expéditeur personnalisé (/fr/features/customized-sender)
Par défaut, Gmail envoie depuis le compte Google qui a autorisé MailG. Vous pouvez tout de même personnaliser l’affichage de votre nom et la destination des réponses.
## Nom de l’expéditeur [#nom-de-lexpéditeur]
1. Ouvrez **More options** dans la sidebar de campagne.
2. Renseignez **Sender name** (placeholder `John Doe (Optional)`).
3. Les destinataires voient ce nom affiché dans leur boîte (selon les règles d’affichage habituelles de Gmail).
## Adresse de réponse [#adresse-de-réponse]
Définissez **Reply to address** (placeholder `john@doe.com (Optional)`) si les réponses doivent aller ailleurs que le compte d’envoi.
## Remarques [#remarques]
* L’adresse From sous-jacente reste le compte Gmail autorisé — vous ne pouvez pas usurper une autre boîte
* Des adresses reply-to invalides peuvent causer des problèmes de livraison ou de réponse — utilisez une boîte que vous contrôlez
* L’aperçu affiche **From:** comme votre e-mail connecté ; confirmez le reply-to avec **Send me a test email**
* Voir [Aperçu et test](/features/preview-and-test)
# Visite de la boîte de dialogue (/fr/getting-started/start-dialog)
Ouvrez le complément via **Extensions → MailG for Gmail → 🚀 Start**. Une boîte 900×600 intitulée **MailG for Gmail** s’ouvre.
## Écrans [#écrans]
| Écran | Accès | Rôle |
| --------------------- | --------------------------------------------- | --------------------------------------------- |
| Root (compositeur) | Par défaut après chargement | Choisir modèle + destinataires, aperçu, envoi |
| Create template | **New Template** | Nom, objet, corps |
| Manage templates | Icône modèle (tooltip **Manage templates**) | Liste, edit, delete |
| Update template | **Edit template** ou **Edit** sur une ligne | Modifier un modèle existant |
| Settings | Engrenage du footer (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | Aucune colonne e-mail valide | Ajouter des contacts ou mock data |
| Erreurs API / feuille | Échec de chargement | Conseils pour réessayer |
## Layout root [#layout-root]
Trois zones :
1. **Sidebar** (gauche) — template, recipient column, **More options**, tracking, branding, quota
2. **Preview** (droite) — From / To / Subject / body, navigation de lignes, **Edit template**
3. **Footer** — bouton d’envoi, menu d’envoi, **Upgrade to Pro** (gratuit), settings, help
## Sidebar (libellés exacts) [#sidebar-libellés-exacts]
* **New Template**
* **Template** (select) — placeholder `Select` ou `No templates found`
* **Recipient column** — options du type `A - Email` ; vide : `No valid email columns found.`
* **More options** — développe **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (activé par défaut)
* **Remove branding** (payant)
* **Daily quota** — reste « N left » et ligne de plan « Your plan sends up to TOTAL/day »
Compte gratuit : **Leave a 5★ review for +N/day free** et **Or upgrade your plan**. Voir [Quota journalier et avis](/help/daily-quota-and-reviews).
## Contrôles d’envoi du footer [#contrôles-denvoi-du-footer]
| Contrôle | Libellé |
| ----------------- | -------------------------------------------------------------------------------------- |
| Bouton principal | **Send N email(s)** (ou **Send emails** si le compteur est 0) |
| Menu d’envoi | **Send me a test email** |
| Menu d’envoi | **Schedule send** |
| Upgrade (gratuit) | **Upgrade to Pro** — tooltip : `Unlock higher quota, send pacing, and remove branding` |
| Engrenage | tooltip **Send pacing** |
| Help | tooltip **Help** — ouvre la checklist dans la boîte |
### Need help? checklist [#need-help-checklist]
1. Pick a template and recipient column
2. Preview each row with the arrows
3. Send a test email to yourself first
4. Click Send to merge from your sheet
Boutons : **Open docs** (ouvre [docs.mailg.io](https://docs.mailg.io)) | **View pricing** (si disponible) | **Close**
## Feuille vide [#feuille-vide]
Si MailG ne trouve aucune colonne e-mail valide :
* Titre : **No email address found in your sheet**
* Actions : **Close** | **Fill with mock data**
Le mock crée les en-têtes `Email`, `First Name`, `Last Name`, `Company` et peut créer **My First Template**.
## Écrans d’erreur [#écrans-derreur]
| Titre | Quand |
| --------------------------------- | ------------------------------ |
| **Could not reach the MailG API** | Échec API / réseau |
| **Could not read your sheet** | Échec de lecture de la feuille |
## Suite [#suite]
# Installer MailG (/fr/getting-started/installation)
Deux étapes : installer le complément, puis le lancer depuis Sheets.
## Installer MailG [#installer-mailg]
1. Ouvrez la [fiche MailG sur Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Cliquez sur **Install**.
3. Choisissez le compte Google concerné.
4. Acceptez les permissions (**Allow**).
L’installation prend généralement moins de 15 secondes.
Si la fiche Marketplace n’est pas encore disponible dans votre région, utilisez le bouton d’install sur [www.mailg.io](https://www.mailg.io) ou écrivez à [contact@mailg.io](mailto:contact@mailg.io).
## Lancer MailG dans Google Sheets [#lancer-mailg-dans-google-sheets]
1. Ouvrez [Google Sheets](https://sheets.google.com) (rafraîchissez si déjà ouvert).
2. Attendez quelques secondes le chargement des Extensions (souvent 10–15 s).
3. Allez dans **Extensions → MailG for Gmail → 🚀 Start**.
Plus tard : **Extensions → MailG for Gmail → 🔄 Refresh Tracking** pour synchroniser les ouvertures sans ouvrir toute la boîte de dialogue.
## Problèmes d’installation [#problèmes-dinstallation]
### Je ne vois jamais le popup « installé avec succès » [#je-ne-vois-jamais-le-popup--installé-avec-succès-]
Souvent lié aux comptes Google multiples.
**Astuce :** fenêtre de navigation privée, un seul compte connecté, puis réinstallez depuis le Marketplace.
### MailG n’apparaît pas sous Extensions [#mailg-napparaît-pas-sous-extensions]
1. Rafraîchissez la feuille.
2. Attendez 10–15 secondes.
3. Vérifiez que vous êtes sur le même compte Google que l’installation.
4. Essayez une autre feuille ou videz le cache du navigateur.
## Déploiements auto-hébergés [#déploiements-auto-hébergés]
Les installs Marketplace sont préconfigurées. En auto-hébergement, définissez les propriétés de script Apps Script :
| Propriété | Valeur |
| ------------- | ------------------------------------- |
| `APP_URL` | URL HTTPS publique de votre API MailG |
| `APP_API_KEY` | Même clé que le serveur API |
Le complément ne peut pas joindre `localhost` — utilisez un tunnel pour les tests locaux.
## Suite [#suite]
Continuez avec le [tutoriel publipostage](/getting-started/mail-merge-tutorial).
# Tutoriel publipostage (/fr/getting-started/mail-merge-tutorial)
Ce parcours correspond à la boîte **MailG for Gmail**.
## 1. Ouvrir MailG [#1-ouvrir-mailg]
**Extensions → MailG for Gmail → 🚀 Start**.
Si vous voyez **No email address found in your sheet**, ajoutez de vrais e-mails ou cliquez sur **Fill with mock data** (crée des lignes d’exemple et souvent **My First Template**). Voir [Visite de la boîte de dialogue](/getting-started/start-dialog).
## 2. Créer ou sélectionner un modèle [#2-créer-ou-sélectionner-un-modèle]
1. Cliquez sur **New Template** (ou choisissez un modèle existant sous **Template**).
2. Renseignez **Template Name** et **Email Subject** (l’objet n’est **pas** fusionné pour l’instant).
3. Rédigez le corps et insérez des [balises de fusion](/features/merge-tags) via **Merge Tag**.
4. **Save Template**.
Exemple de corps :
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Configurer la campagne [#3-configurer-la-campagne]
Dans la sidebar :
1. Choisissez **Recipient column** (les cellules doivent contenir une adresse e-mail valide et unique pour que l’UI les compte).
2. Ouvrez **More options** pour **CC**, **BCC**, **Sender name**, **Reply to address**.
3. Laissez **Track emails** activé (défaut) si vous voulez le statut d’ouverture dans la feuille.
4. Sur une offre payante, activez **Remove branding**.
**Attachments** apparaît sous **More options**, mais les fichiers ne sont pas encore joints à l’envoi. Liez plutôt vers Drive ou une URL dans le corps.
## 4. Prévisualiser et tester [#4-prévisualiser-et-tester]
1. Utilisez les flèches précédent/suivant pour parcourir les lignes.
2. Confirmez **To:** et le corps fusionné (l’objet affiche l’objet brut du modèle).
3. Menu d’envoi → **Send me a test email**.
4. Vérifiez votre boîte de réception.
Détails : [Aperçu et test](/features/preview-and-test).
## 5. Envoyer ou planifier [#5-envoyer-ou-planifier]
* Bouton principal : **Send N email(s)** quand les destinataires sont comptés.
* Ou menu d’envoi → **Schedule send** → choisissez date/heure → **Schedule Send**.
Overlays de chargement : `Starting your campaign…` / toasts de confirmation de planification.
MailG ajoute une colonne de campagne du type `🚀 My Template (yyyy/MM/dd)` ou `🗓️ …` en cas de planification.
Statuts de ligne :
| Statut | Signification |
| ------------- | ------------------------ |
| 🗓️ Scheduled | En attente du démarrage |
| ⏳ Sending… | En traitement |
| ✉️ Sent | Remis à Gmail |
| ⚠️ Failed | Erreur |
| 👀 Opened | Pixel d’ouverture chargé |
## Erreurs fréquentes [#erreurs-fréquentes]
* Balises dans l’objet en attente de personnalisation — corps uniquement pour l’instant
* Cellules destinataire avec plusieurs adresses séparées par des virgules — l’UI valide **une** adresse par cellule pour le comptage
* Mauvais compte Google par rapport au compte d’installation
* Quota journalier atteint — vérifiez **Daily quota** dans la sidebar
## Astuces [#astuces]
* Utilisez la checklist **Help** du footer la première fois
* Commencez avec 2–3 vraies lignes après les mock data
* Après des ouvertures : **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alerte `Tracking info synced` (ou `No active campaigns`)
## Suite [#suite]
# Qu’est-ce que MailG ? (/fr/getting-started/what-is-mailg)
MailG transforme une Google Sheet en campagne de publipostage. Chaque ligne est un destinataire ; les en-têtes de colonnes deviennent des balises de fusion (doubles accolades autour du nom d’en-tête) dans le **corps** de l’e-mail.
## Ce que vous pouvez faire [#ce-que-vous-pouvez-faire]
* Créer des modèles cloud (**Template Name**, **Email Subject**, corps enrichi)
* Personnaliser le **corps** avec des balises de fusion issues des en-têtes de feuille
* Prévisualiser les lignes et **Send me a test email**
* Mapper **CC** / **BCC**, **Sender name**, **Reply to address**
* **Schedule send** ou envoyer immédiatement
* **Track emails** avec des pastilles de statut d’ouverture dans la feuille
* Contrôler **Send pacing** sur les offres payantes
* **Remove branding** sur les offres payantes
* Surveiller **Daily quota** (et éventuellement réclamer un bonus avis gratuit)
## Comment tout s’articule [#comment-tout-sarticule]
1. **Complément Google Sheets** — boîte sous **MailG for Gmail**
2. **API MailG** — modèles, métadonnées de campagne, suivi d’ouvertures, droits
3. **Votre Gmail** — messages envoyés avec `GmailApp` depuis le compte autorisé
## Prochaines étapes [#prochaines-étapes]
# Kontakt (/de/contact-us)
## Abrechnung & Abonnements [#abrechnung--abonnements]
Die meisten Abonnementänderungen können Sie über das Stripe-Portal verwalten, das über [pricing](https://app.mailg.io/pricing?lang=de) verlinkt ist. Bei Erstattungen oder Zahlungsproblemen schreiben Sie uns per E-Mail.
## Alles andere [#alles-andere]
E-Mail an **[contact@mailg.io](mailto:contact@mailg.io)**.
Wir antworten in der Regel innerhalb eines Werktags.
## Nützliche Links [#nützliche-links]
* [Website](https://www.mailg.io)
* [Pricing](https://app.mailg.io/pricing?lang=de)
* [Privacy](https://www.mailg.io/de/privacy)
* [Terms](https://www.mailg.io/de/terms)
* [Documentation home](/)
# MailG-Dokumentation (/de)
MailG ist ein Google-Sheets-Add-on für Mail Merge mit Gmail. Öffnen Sie **Extensions → MailG for Gmail → 🚀 Start**, erstellen Sie ein Template, sehen Sie Zeilen in der Vorschau und senden oder planen Sie von Ihrem eigenen Gmail-Konto aus.
## Hier starten [#hier-starten]
## Beliebte Themen [#beliebte-themen]
## Nützliche Links [#nützliche-links]
* Website: [www.mailg.io](https://www.mailg.io)
* Dokumentation: [docs.mailg.io/de](https://docs.mailg.io/de)
* Preise: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=de)
* Kontakt: [contact@mailg.io](mailto:contact@mailg.io)
## Für KI-Assistenten / LLMs [#für-ki-assistenten--llms]
Bevorzugen Sie diese maschinenlesbaren Endpunkte statt HTML zu scrapen:
* [Agents hub](https://www.mailg.io/de/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/de/help/faq)
## Installation & Öffnen [#installation--öffnen]
**Wie öffne ich MailG?**\
**Extensions → MailG for Gmail → 🚀 Start**. Siehe [Installation](/getting-started/installation).
**No email address found in your sheet**\
E-Mails in eine Spalte eintragen oder **Fill with mock data** klicken. Siehe [Start-Dialog-Tour](/getting-started/start-dialog).
**Could not reach the MailG API**\
Netzwerk / API-URL prüfen (self-hosted: `APP_URL` + `APP_API_KEY`). Dialog nach Fix neu öffnen.
## Senden [#senden]
**E-Mails werden nicht gesendet**\
**Daily quota**, Gmail-Berechtigungen und gültige einzelne E-Mails in **Recipient column** prüfen. Fehler zeigen **⚠️ Failed**.
**Funktionieren Subject merge tags?**\
Noch nicht. Nur der **body** wird gemerged. Festen Betreff nutzen oder Personalisierung im Body. Siehe [Merge tags](/features/merge-tags).
**Kann ich Dateien anhängen?**\
Der **Attachments**-Picker existiert unter **More options**, aber Dateien werden beim Senden noch nicht angehängt. Links nutzen.
**Wie stoppe ich eine Kampagne?**\
[Stopping a campaign](/features/stopping-a-campaign) — sendbare Status auf verbleibenden Zeilen löschen.
**Warum bin ich auf Professional limitiert?**\
MailG erlaubt bis zu 1.500/Tag, aber free `@gmail.com` ist von Google oft nahe 500 gedeckelt.
## Tracking [#tracking]
**Sheet zeigt noch Sent nach Open**\
**🔄 Refresh Tracking** → erwarten Sie `Tracking info synced`. Manche Clients laden nie Bilder.
**Klicks?**\
Nicht getrackt. **Track emails** = nur Opens.
## Quota & Abrechnung [#quota--abrechnung]
Siehe [Daily quota & reviews](/help/daily-quota-and-reviews) und [Account & billing](/help/account-and-billing).
**Ist Schedule send paid?**\
Nein. Paid schaltet höhere Quotas, Pacing-Modi und **Remove branding** frei.
## Fehlerbehebung [#fehlerbehebung]
Schritt-für-Schritt-Fixes (API-Fehler, leeres Sheet, deaktivierter Send-Button, fehlgeschlagene Zeilen, Tracking, Quota, Schedule deferring nicht): siehe [Troubleshooting](/help/troubleshooting).
Häufige Toasts:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Immer noch hängen? [#immer-noch-hängen]
[Troubleshooting](/help/troubleshooting) · Docs [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Fehlerbehebung (/de/help/troubleshooting)
Schnelle Fixes für Meldungen und Zustände im Add-on.
## Dialog lädt nicht [#dialog-lädt-nicht]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
Der Start-Dialog konnte das MailG-Backend nicht aufrufen.
* Online-Status prüfen
* Marketplace-Installs: kurz warten und **🚀 Start** neu öffnen
* Self-hosted: Apps-Script-Properties `APP_URL` (öffentliches HTTPS) und `APP_API_KEY` prüfen
* Add-on kann `localhost` nicht nutzen — Tunnel für lokale API-Tests
### Could not read your sheet [#could-not-read-your-sheet]
MailG konnte die aktive Tabelle nicht lesen.
* Sicherstellen, dass ein Sheet-Tab offen ist (nicht nur Apps-Script-Editor)
* Tabelle neu laden, dann Dialog neu öffnen
* Bearbeitungszugriff auf die Datei bestätigen
### Loading… endet nie [#loading-endet-nie]
Dialog schließen, Sheets aktualisieren, \~15 Sekunden auf Extensions warten, dann **🚀 Start** erneut.
## Leeres Blatt [#leeres-blatt]
**No email address found in your sheet**
MailG braucht mindestens eine Spalte mit gültigen E-Mail-Adressen.
* E-Mails unter Header eintragen oder **Fill with mock data** klicken
* Mock-Daten erstellen `Email`, `First Name`, `Last Name`, `Company` und oft **My First Template**
Siehe [Start-Dialog-Tour](/getting-started/start-dialog).
## Vorlagen [#vorlagen]
* Create: `Creating Template...` → `Template created successfully!` oder `Failed to create template! Try again later.`
* Update: `Updating template...`
* Delete failures: `Failed to delete template. Try again later`
Siehe [Templates](/features/templates).
## Sendeprobleme [#sendeprobleme]
### Send button disabled / Send emails ohne Zählung [#send-button-disabled--send-emails-ohne-zählung]
* **Template** wählen
* **Recipient column** mit gültigen **einzelnen** E-Mails pro Zelle
* Guard toasts: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### Kampagne startet nicht [#kampagne-startet-nicht]
Toast: `Failed to create campaign. Please try again.`
* Einmal erneut versuchen
* **Daily quota** ist nicht 0
* API-Konnektivität prüfen (siehe oben)
### Zeilen zeigen ⚠️ Failed [#zeilen-zeigen-️-failed]
Sendefehler in dieser Zeile (ungültige Adresse, Gmail-Ablehnung, transiente Quota usw.). Daten fixen und neue Kampagne für verbleibende Zeilen, oder siehe [Stopping a campaign](/features/stopping-a-campaign).
### Test-E-Mail schlägt fehl [#test-e-mail-schlägt-fehl]
* `Configure your preview first` — Template + Empfänger für To in der Vorschau
* `Failed to send test email. Please check your email settings.` — Gmail ggf. neu autorisieren, erneut versuchen
## Tracking [#tracking]
* Opens brauchen geladene Remote-Bilder beim Empfänger
* **🔄 Refresh Tracking** — erwarten Sie `Tracking info synced` oder `No active campaigns`
* Status **👀 Opened** nur, wenn Pixel lädt
Siehe [Email tracking](/features/email-tracking).
## Quota & Branding [#quota--branding]
* Sidebar **N left** ist `min(MailG remaining, Gmail remaining)`
* Free `@gmail.com` oft nahe 500/Tag von Google gedeckelt, auch auf Professional
* Wasserzeichen nach Zahlung noch da → Checkout-E-Mail muss Sheets-Konto entsprechen; Dialog neu öffnen
Siehe [Daily quota & reviews](/help/daily-quota-and-reviews) und [Remove branding](/features/remove-branding).
## Schedule hat nicht deferred [#schedule-hat-nicht-deferred]
Zeiten weniger als etwa **15 Sekunden** voraus gelten als **immediate** send (🚀 Spalte), nicht als aufgeschobener 🗓️ schedule. Weiter in der Zukunft wählen.
## Immer noch hängen? [#immer-noch-hängen]
Volle FAQ: [FAQ](/help/faq) · E-Mail [contact@mailg.io](mailto:contact@mailg.io) · Site [app.mailg.io/help](https://www.mailg.io/de/help)
# Tageskontingent und Bewertungen (/de/help/daily-quota-and-reviews)
Die Root-Sidebar zeigt Ihre Sendekapazität, wenn Kontodaten geladen sind.
## Daily-quota-Block [#daily-quota-block]
Exakte UI:
* Label: **Daily quota**
* Remaining: **N left**
* Plan line: **Your plan sends up to TOTAL/day**
**Remaining** ist das Minimum aus:
1. MailG-Plan-Rest für den Tag
2. Gmail remaining send quota für das Konto
Sie können also von Gmail gedeckelt sein, obwohl MailG auf dem Papier noch Spielraum zeigt. Siehe auch [Account & billing](/help/account-and-billing).
## Free-Plan-CTAs [#free-plan-ctas]
Ohne Abo kann die Sidebar zeigen:
* **Leave a 5★ review for +N/day free** (Standardbonus **+50/day**, wenn die API nichts anderes angibt)
* **Or upgrade your plan**
Review-CTA öffnet **Free Quota upgrade**:
* Title: **Free Quota upgrade**
* Body: leave a 5-star review to get a free quota upgrade of **+N emails/day**
* Buttons: **Not now** | **Leave a 5★ review**
Ist die Review-URL nicht konfiguriert, bleibt **Leave a 5★ review** deaktiviert — **Upgrade to Pro** / pricing nutzen.
## Auf Pro upgraden [#auf-pro-upgraden]
Footer-Button (Free-Konten): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
Entspricht dem, was Paid-Pläne heute freischalten.
## Verwandt [#verwandt]
* [Remove branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Konto und Abrechnung (/de/help/account-and-billing)
MailG-Abrechnung ist an die **E-Mail Ihres Google-Kontos** in Sheets gebunden. Checkout immer mit derselben Adresse, damit Quotas im Add-on freigeschaltet werden.
## Pläne & Daily quotas [#pläne--daily-quotas]
| Plan | Daily quota | Hinweise |
| ------------ | ----------- | ------------------------------------- |
| Free | 50 | Kern-Merge, Open-Tracking, Scheduling |
| Personal | 250 | Beliebter Plan für wachsende Listen |
| Professional | 1,500 | Höchste wiederkehrende Quota |
| Lifetime | 1,500 | Einmalkauf |
Preise und Intervalle auf [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=de) (EUR und USD).
Paid-Berechtigungen schalten außerdem frei:
* Nicht-Standard-[send pacing](/features/send-pacing) (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Ihr effektives Sendvolumen ist `min(MailG daily quota, Gmail remaining quota)`.
## Upgrade [#upgrade]
1. [pricing](https://app.mailg.io/pricing?lang=de) öffnen (auch im Add-on über **Upgrade to Pro** verlinkt).
2. Plan wählen und Stripe Checkout mit Ihrer Sheets-Google-E-Mail abschließen.
3. MailG in Sheets neu öffnen, damit die Kontenaktualisierung das neue Limit übernimmt.
## Abo kündigen oder ändern [#abo-kündigen-oder-ändern]
Kündigung oder Änderung über das Stripe-Kundenportal in Ihrem Abo- / Pricing-Flow.
* Bei Kündigung mid-cycle bleiben Premium-Funktionen bis Periodenende aktiv
* Nach wirksamer Kündigung keine weiteren Abbuchungen
## Erstattungen [#erstattungen]
Bei Kündigung eines Premium-Abos innerhalb von **30 Tagen** nach Kauf können Sie per E-Mail an [contact@mailg.io](mailto:contact@mailg.io) eine volle Erstattung anfragen.
## Rechnungen [#rechnungen]
Stripe sendet Belege für erfolgreiche Zahlungen. Rechnungen auch im Stripe-Kundenportal zum Abo-Management.
## FAQ-Snippets [#faq-snippets]
**Ist MailG in Google Workspace enthalten?**\
Nein. MailG ist unabhängig von Google. Ein Workspace-Abo enthält kein MailG.
**Welche Zahlungsmethoden?**\
Gängige Karten, Google Pay und Apple Pay über Stripe. PayPal nicht unterstützt.
**Gezahlt, aber noch Free-Limit / Wasserzeichen**\
Fast immer E-Mail-Mismatch. Checkout-E-Mail = Sheets-Konto, dann Add-on neu öffnen. Bei anhaltendem Problem Support mit beiden E-Mails.
**Warum ist Free Gmail auf \~500 E-Mails/Tag limitiert?**\
MailG Professional erlaubt bis 1.500/Tag, aber Google limitiert free `@gmail.com` auf etwa 500 Sends/Tag. Google Workspace kann höher. Das ist ein Gmail-Provider-Limit, kein MailG-Limit.
# Kampagnenplanung (/de/features/campaign-scheduling)
**Schedule send** nutzen, wenn MailG später starten soll. Verfügbar in Free- und Paid-Plänen.
## So planen Sie [#so-planen-sie]
1. Template und Empfänger so konfigurieren, dass der Send-Button aktiv ist.
2. Send-Menü (Chevron) → **Schedule send**.
3. Dialogtitel: **Schedule send**
4. Beschreibung: `Pick date & time to schedule sending`
5. Summary-Zeile: scheduling N emails to be sent starting at the chosen date/time
6. Datums-Picker plus **Hour** / **Minute** (Platzhalter `Hour`, `Min`).
7. Mit **Schedule Send** bestätigen (oder **Cancel**).
Standardvorschlag etwa **60 Minuten** voraus, auf den nächsten **15-Minuten**-Schritt gerundet.
## Sofort vs. geplant [#sofort-vs-geplant]
Zeiten weniger als etwa **15 Sekunden** voraus gelten als **immediate** send (🚀 Spaltenheader), nicht als aufgeschobener 🗓️ schedule. Für aufgeschobenes Senden weiter in der Zukunft wählen.
Validation toasts: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Success toast: campaign scheduled; N emails will start at the chosen time.
## Sheet-Spalte [#sheet-spalte]
Geplante Kampagnen erzeugen einen Spaltenheader wie:
```text
🗓️ Template name (yyyy/MM/dd)
```
Sofortsendungen nutzen 🚀 statt 🗓️.
Zeilen starten als **🗓️ Scheduled**, wechseln zu **⏳ Sending…**, wenn die Queue läuft.
## Nach der Planung [#nach-der-planung]
* Tabelle für das Google-Konto mit Add-on-Zugriff erreichbar halten
* Tracking und Pacing gelten weiter, sobald das Senden startet
* Kein **Manage Schedule**-UI — siehe [Stopping a campaign](/features/stopping-a-campaign)
## Verwandt [#verwandt]
* [Preview & test](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Mehrere Empfänger (/de/features/multiple-recipients)
Carbon-Copy-Empfänger pro Zeile mit dedizierten Sheet-Spalten hinzufügen.
## Empfängerspalte (An) [#empfängerspalte-an]
**Recipient column** in der Sidebar wählen.
Für Send-Button-Zählung und Spaltenvalidierung gilt eine Zelle als gültig, wenn sie **eine einzelne** E-Mail-Adresse enthält. Bevorzugen Sie eine primäre To-Adresse pro Zeile.
## CC- und BCC-Spalten [#cc--und-bcc-spalten]
1. Spalten im Sheet anlegen (z. B. `CC` und `BCC`).
2. E-Mail (oder Gmail-akzeptierte Liste) in die Zelle.
3. **More options** öffnen und **CC** / **BCC** zuordnen.
4. Beim Senden gehen die Werte an Gmail.
Der Preview-Bereich zeigt nur **From**, **To**, **Subject** und body. CC/BCC-Zeilen werden **nicht** angezeigt, auch wenn zugeordnet. Mit **Send me a test email** prüfen, wenn CC/BCC-Zustellung wichtig ist.
## Kontingente: MailG vs. Gmail [#kontingente-mailg-vs-gmail]
* **MailG daily quota** zählt **Kampagnenzeilen**, die verarbeitet werden.
* **Gmail sending limits** zählen **Empfänger** (To + CC + BCC, die Gmail beim Send akzeptiert).
Sie können Gmails Limit erreichen, während MailG-Quota noch übrig ist.
## Tipps [#tipps]
* **BCC** bevorzugen, wenn Empfänger sich nicht sehen sollen
* CC/BCC unmapped lassen, wenn ungenutzt
* Adressen vor großem Send validieren
# Attachments (/de/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Funktionsübersicht (/de/features/features-overview)
Was das Add-on heute unterstützt:
| Funktion | Docs |
| ------------------------------------------- | ------------------------------------------------------ |
| Start dialog / empty sheet / mock data | [Start-Dialog-Tour](/getting-started/start-dialog) |
| Templates (create / manage / edit / delete) | [Templates](/features/templates) |
| Merge tags in **body** | [Merge tags](/features/merge-tags) |
| Rich-text toolbar | [Rich-text emails](/features/rich-text-emails) |
| Links (not image embeds) | [Images](/features/images) |
| Preview + test email | [Preview & test](/features/preview-and-test) |
| Schedule send | [Campaign scheduling](/features/campaign-scheduling) |
| Send pacing (paid) | [Send pacing](/features/send-pacing) |
| CC / BCC columns | [Multiple recipients](/features/multiple-recipients) |
| Track emails | [Email tracking](/features/email-tracking) |
| Sender name & reply-to | [Customized sender](/features/customized-sender) |
| Remove branding (paid) | [Remove branding](/features/remove-branding) |
| Stop remaining rows | [Stopping a campaign](/features/stopping-a-campaign) |
| Daily quota + review bonus | [Daily quota & reviews](/help/daily-quota-and-reviews) |
## Bezahlt vs. kostenlos [#bezahlt-vs-kostenlos]
Paid schaltet frei:
* Nicht-Standard-[send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* Höhere [daily quotas](/help/account-and-billing)
**Schedule send**, **Track emails** und Template-Tools funktionieren ohne Paid-Upgrade.
## Bekannte Lücken (ehrlich) [#bekannte-lücken-ehrlich]
| Thema | Status im Produkt |
| ----------------------- | --------------------------------------- |
| Subject merge tags | Beim Senden nicht angewendet — nur Body |
| Attachments column | Nur UI — beim Senden nicht angehängt |
| Image embeds | Kein Editor-Control — Links nutzen |
| Preview CC/BCC lines | Nicht in der Preview-UI angezeigt |
| Manage Schedule / Pause | Nicht verfügbar — Status-Workaround |
## Später geplant [#später-geplant]
Unsubscribe-Links, Click-Tracking, geteilte Team-Plätze und eine dedizierte Campaign-Manager-UI, wenn sie verfügbar sind.
# E-Mail-Tracking (/de/features/email-tracking)
MailG kann Opens mit einem winzigen unsichtbaren Pixel erfassen.
## Tracking aktivieren [#tracking-aktivieren]
In der Sidebar **Track emails** anlassen (Standard für neue Jobs ist an).
Tooltip: `Track emails opened with a tiny pixel`
Das Hilfe-Icon öffnet **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Button: **Got it**
## Sheet-Status [#sheet-status]
| Status | Bedeutung |
| ------------- | ---------------------------------- |
| 🗓️ Scheduled | Wartet auf geplanten Start |
| ⏳ Sending… | Wird gerade verarbeitet |
| ✉️ Sent | Für diese Zeile an Gmail übergeben |
| ⚠️ Failed | Sendefehler für diese Zeile |
| 👀 Opened | Open-Pixel wurde geladen |
Kampagnen-Spaltenheader wie `🚀 Template name (yyyy/MM/dd)` oder `🗓️ …` bei Planung.
## Tracking aktualisieren [#tracking-aktualisieren]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Apps-Script-Alerts:
* `Tracking info synced`
* `No active campaigns`
## Einschränkungen [#einschränkungen]
* Client muss Remote-Bilder laden
* Privacy-Proxies können Opens verbergen
* Nur Opens — keine Link-Klicks
## Verwandt [#verwandt]
* [Campaign scheduling](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Merge-Tags (/de/features/merge-tags)
Merge tags geben jedem Empfänger einen personalisierten **body**. Ein Tag ist der **exakte Spaltenheader** in doppelten geschweiften Klammern.
## Syntax [#syntax]
Hat Ihr Sheet eine Spalte `First Name`, nutzen Sie:
```text
{{First Name}}
```
Body-Beispiel:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Wo Merge tags heute funktionieren [#wo-merge-tags-heute-funktionieren]
| Feld | Beim Senden gemerged? |
| --------------- | ---------------------------------------------- |
| Email body | **Ja** — Variablen pro Zeile eingesetzt |
| Email subject | **Nein** — Betreff wie im Template gespeichert |
| Preview body | **Ja** — für die aktive Zeile |
| Preview subject | **Nein** — zeigt den rohen Template-Betreff |
Personalisierung im Body, bis Subject-Merge verfügbar ist.
## Tags einfügen [#tags-einfügen]
In der Editor-Toolbar **Merge Tag** öffnen. Listet Header aus dem aktiven Sheet. Empty state: `No sheet columns found`.
Eingefügter Text nutzt doppelte geschweifte Klammern um den Spaltennamen.
## Faustregeln [#faustregeln]
* Header sind case-sensitive (`Name` ≠ `name`)
* Leere Zellen werden als leere Strings eingesetzt
* Dasselbe Tag kann mehrfach im Body vorkommen
* Recipient / CC / BCC werden unter **More options** gewählt, nicht per Merge tags
## Weiter [#weiter]
Siehe [Rich-text emails](/features/rich-text-emails) und [Preview & test](/features/preview-and-test).
# Rich-Text-E-Mails (/de/features/rich-text-emails)
MailG-Templates nutzen einen TipTap-Rich-Text-Editor. Das HTML wird so an Gmail übergeben.
Body-Platzhalter: `Write your email…`
## Toolbar-Inventar (exakte UI) [#toolbar-inventar-exakte-ui]
| Gruppe | Steuerung |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (Presets in der Toolbar) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | Preset swatches + native color picker + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — URL-Feld-Platzhalter `https://example.com`, dann **Apply** (und unlink) |
| History | **Undo**, **Redo** |
## Nicht im Editor [#nicht-im-editor]
Diese TipTap-Funktionen sind deaktiviert / nicht vorhanden:
* Headings, code, code block, blockquote, horizontal rule
* Image insert / Drive media picker — siehe [Images](/features/images)
## Hyperlinks [#hyperlinks]
**Insert link** für URL und sichtbaren Text. Klaren Linktext statt roher URLs bevorzugen.
## Tipps [#tipps]
* **Merge Tag** statt Klammern von Hand tippen
* Mehrere Zeilen in der Vorschau vor dem Senden — siehe [Preview & test](/features/preview-and-test)
* Riesiges Word/Docs-Markup vermeiden; Formatierung in MailG neu anwenden für saubereres HTML
# MailG-Branding entfernen (/de/features/remove-branding)
Free-Kampagnen können ein kleines MailG-Wasserzeichen im E-Mail-Footer enthalten. Paid-Abonnenten können es ausschalten.
## Branding entfernen [#branding-entfernen]
1. Aktiven Paid-Plan bestätigen (Personal, Professional oder Lifetime).
2. Kampagnen-Sidebar öffnen.
3. **Remove branding** aktivieren.
4. Zeile in der Vorschau prüfen, dass das Wasserzeichen weg ist, dann senden.
Erscheint Branding nach Zahlung noch:
* Checkout mit **derselben E-Mail** wie Ihr Google-Sheets-Konto
* Add-on neu öffnen, damit Berechtigungen von der API aktualisiert werden
* [contact@mailg.io](mailto:contact@mailg.io) mit Ihrer Google-Konto-E-Mail kontaktieren
Siehe [Account & billing](/help/account-and-billing).
# Bilder (/de/features/images)
Der MailG-Editor hat **keinen Image-Insert-Button** und keinen Google-Drive-Media-Picker. Die TipTap-Image-Extension ist nicht aktiv.
## Was heute möglich ist [#was-heute-möglich-ist]
**Insert link** in der Toolbar nutzen:
1. Bild (oder Datei) unter einer öffentlichen URL hosten oder Drive-Link teilen.
2. Text markieren (oder Cursor setzen) → **Insert link**.
3. URL einfügen (Platzhalter `https://example.com`) → **Apply**.
Empfänger öffnen den Link, um Bild oder Datei zu sehen. Der Editor bettet keine `![]()
`-Tags für Sie ein.
## Tipps [#tipps]
* Kleine Dateien und klaren Linktext bevorzugen („View screenshot“)
* Links mit Login scheitern für Empfänger
* Mit **Send me a test email** prüfen
## Später geplant [#später-geplant]
Ein erstklassiges Image-Embed / Drive-Picker kann später kommen. Bis dahin sind Hyperlinks der unterstützte Weg.
# Vorlagen (/de/features/templates)
Templates speichern Betreff und Rich-Text-Body, die Sie in Kampagnen wiederverwenden. Sie werden in der MailG-API für Ihr Google-Konto gespeichert.
## Template erstellen [#template-erstellen]
1. Auf dem Root-Bildschirm **New Template** klicken.
2. Ausfüllen:
* **Template Name**
* **Email Subject**
* Body (Rich-Editor — siehe [Rich-text emails](/features/rich-text-emails))
3. **Save Template** klicken (zeigt **Saving...** während der Arbeit).
Toasts:
* Loading: `Creating Template...`
* Success: `Template created successfully!`
* Error: `Failed to create template! Try again later.`
Demo-Template von **Fill with mock data**: Name **My First Template**, Betreff `I found a mail merge tool for Gmail`.
## Vorlagen verwalten [#vorlagen-verwalten]
Template-Symbol neben der Template-Auswahl öffnen (Tooltip **Manage templates**).
Tabellenspalten:
| Spalte | Inhalt |
| ----------------- | ---------------- |
| **Name** | Template-Name |
| **Email Subject** | Betreffzeile |
| **Created At** | Erstellungsdatum |
| **Actions** | Zeilenmenü |
Zeilenmenü: **Edit** | **Delete**
Footer: **Back**
Delete-Toasts: deleting template NAME → template NAME deleted successfully (oder Fehlermeldung).
## Template bearbeiten [#template-bearbeiten]
**Edit** aus Manage öffnen oder **Edit template** in der Preview-Toolbar klicken.
Gleiche Felder wie beim Erstellen. **Save Template** aktualisiert das Template.
Der Update-Flow zeigt einen Loading-Toast (`Updating template...`). Bleiben Sie im Formular, bis er fertig ist, dann **Cancel** oder **Back**, falls Sie nicht automatisch zurückkehren.
## Betreff vs. Body [#betreff-vs-body]
* **Body** unterstützt [merge tags](/features/merge-tags) — sie werden pro Zeile beim Senden eingesetzt.
* **Email Subject** wird heute wie gespeichert gesendet (Merge-Tags im Betreff werden **noch nicht** ersetzt). Personalisierung in den Body oder festen Betreff setzen.
## Verwandt [#verwandt]
* [Preview & test](/features/preview-and-test)
* [Start-Dialog-Tour](/getting-started/start-dialog)
# Vorschau und Test (/de/features/preview-and-test)
Der Preview-Bereich (rechts im Root-Dialog) zeigt, wie eine Nachricht für die aktive Sheet-Zeile aussieht.
## Was die Vorschau zeigt [#was-die-vorschau-zeigt]
| Feld | Inhalt |
| ------------ | ----------------------------------------------------------------------------------- |
| **From:** | E-Mail Ihres angemeldeten Google-Kontos |
| **To:** | Wert aus **Recipient column** für die aktive Zeile oder `Select a recipient column` |
| **Subject:** | Template-Betreff wie gespeichert (nicht merge-substituiert) |
| Body | Template-Body mit Merge tags für diese Zeile |
Ist **Remove branding** aus, enthält die Vorschau den MailG-Wasserzeichen-Footer (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## Was nicht angezeigt wird [#was-nicht-angezeigt-wird]
* **CC** / **BCC**-Zeilen werden in der Preview-UI nicht gerendert (auch wenn unter **More options** zugeordnet). Sie gelten trotzdem beim Senden.
* Attachment-Spaltenwerte erscheinen nicht in der Vorschau.
## Zeilen navigieren [#zeilen-navigieren]
Preview-Toolbar:
* **Edit template** — öffnet Update-Template-Bildschirm
* **Previous recipient** / **Next recipient** — zwischen Datenzeilen (Tooltips können Sheet-Zeilennummer enthalten; Header ist Zeile 1, erster Kontakt Zeile 2)
## Test-E-Mail an mich senden [#test-e-mail-an-mich-senden]
1. Template + Recipient column so konfigurieren, dass die Vorschau gültig ist.
2. Send-Menü (Chevron) → **Send me a test email**.
3. Busy overlay: `Sending test email…`
4. Success toast: `Test email sent successfully. Check your inbox.`
5. Failure toast: `Failed to send test email. Please check your email settings.`
6. Guard bei unvollständiger Vorschau: `Configure your preview first`
Der Test geht an **Ihren** Google-Posteingang mit dem gemergten Body der aktiven Preview-Zeile.
## Tipps [#tipps]
* Mehrere Zeilen mit den Pfeilen durchgehen vor vollem Send
* Branding / kein Branding in der Vorschau prüfen
* Immer testen vor **Schedule send** oder großem **Send N email(s)**
## Verwandt [#verwandt]
* [Merge tags](/features/merge-tags)
* [Mail-Merge-Tutorial](/getting-started/mail-merge-tutorial)
# Send-Taktung (/de/features/send-pacing)
Send pacing fügt Verzögerung zwischen Nachrichten ein, damit eine große Kampagne nicht als ein Burst Ihr Konto verlässt.
**Steady pace** und **Jittered gaps** erfordern ein aktives Paid-MailG-Abonnement. Free-Konten nutzen nur **Burst send**.
## Wo konfigurieren [#wo-konfigurieren]
Footer-Zahnrad (Tooltip **Send pacing**). Bildschirmüberschrift: **Send pacing**.
Unter **Dispatch mode** wählen, wie E-Mails verteilt werden. **Gap between emails** in **seconds** (0–60). Free-Konten sehen **Pro features** und den gesperrten Text: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Standard für neue Jobs: **Burst send**, gap **10s** (gap ignoriert, bis Sie Burst verlassen).
## Modi [#modi]
| Mode (UI label) | Verhalten |
| ------------------------ | ------------------------------------------------ |
| **Burst send** (default) | So schnell wie Quotas erlauben |
| **Steady pace** | Feste Lücke zwischen jeder E-Mail |
| **Jittered gaps** | Zufällige Lücke zwischen 0 und gewähltem Maximum |
## Warum Pacing [#warum-pacing]
* Geringeres Risiko, wie ein plötzlicher Blast für Mailbox-Provider zu wirken
* Lange Liste über ein ruhigeres Sendfenster strecken
* In Gmail-Komfortzonen für Ihren Kontotyp bleiben
## Hinweise [#hinweise]
* Pacing ist eine Kampagnen-Einstellung im Job — neue Sends nutzen die aktuelle Konfiguration
* Lange Lücke bei großer Liste verlängert die Kampagnendauer deutlich
* Effektive Geschwindigkeit bleibt durch MailG daily quota **und** Gmail remaining send quota begrenzt
* Konkurrenztools nutzen manchmal Minuten — MailG nutzt **seconds**
## Verwandt [#verwandt]
* [Stopping a campaign](/features/stopping-a-campaign), wenn die Lücke mid-run zu hoch war
* [Account & billing](/help/account-and-billing)
# Kampagne stoppen (/de/features/stopping-a-campaign)
MailG bietet noch keinen dedizierten **Manage Schedule**-, **Abort**- oder **Pause**-Bildschirm wie manche Konkurrenz. Sie können trotzdem **verbleibende** Zeilen vom Senden abhalten.
## Wie die Send-Schleife entscheidet, was verarbeitet wird [#wie-die-send-schleife-entscheidet-was-verarbeitet-wird]
Die Schleife verarbeitet nur Zeilen, deren Kampagnen-Spalten-Status noch sendbar ist:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
Zeilen bereits **✉️ Sent**, **⚠️ Failed** oder **👀 Opened** werden übersprungen.
## Verbleibende Zeilen stoppen (ehrlicher Workaround) [#verbleibende-zeilen-stoppen-ehrlicher-workaround]
Bei großer Kampagne schnell handeln:
1. Tabelle öffnen.
2. In der Kampagnen-Status-Spalte Status auf Zeilen löschen/ändern, die **nicht** senden sollen (z. B. Zellenwert löschen oder nicht-sendbares Label wie `Stopped`).
3. Bereits **✉️ Sent**-Zeilen unangetastet lassen — diese Nachrichten sind bereits raus.
Gelöschte/geänderte Zeilen passen nicht mehr zu sendbaren Status und werden in der nächsten Runde übersprungen.
Gmail-Nachrichten, die das Konto bereits verlassen haben, kann MailG nicht zurücknehmen. Stoppen schützt nur noch nicht verarbeitete Zeilen.
## Geplante Kampagnen, die noch nicht gestartet sind [#geplante-kampagnen-die-noch-nicht-gestartet-sind]
Sind alle Zeilen noch **🗓️ Scheduled** und die Startzeit nicht erreicht, verhindert das Löschen dieser Status (oder der Kampagnen-Spalte), dass die Queue sie zum Startzeitpunkt aufnimmt.
Bei Unsicherheit [contact@mailg.io](mailto:contact@mailg.io) mit Tabellen-URL und Kampagnendetails kontaktieren.
## Verwandt [#verwandt]
* [Campaign scheduling](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Angepasster Absender (/de/features/customized-sender)
Standardmäßig sendet Gmail vom Google-Konto, das MailG autorisiert hat. Sie können trotzdem anpassen, wie Ihr Name erscheint und wohin Antworten gehen.
## Absendername [#absendername]
1. **More options** in der Kampagnen-Sidebar öffnen.
2. **Sender name** setzen (Platzhalter `John Doe (Optional)`).
3. Empfänger sehen diesen Anzeigenamen im Posteingang (Gmails übliche Darstellungsregeln).
## Antwortadresse [#antwortadresse]
**Reply to address** setzen (Platzhalter `john@doe.com (Optional)`), wenn Antworten woanders hin sollen als zum Sendekonto.
## Hinweise [#hinweise]
* Die zugrunde liegende From-Adresse bleibt das autorisierte Gmail-Konto — kein Spoofing anderer Postfächer
* Ungültige Reply-to-Adressen können Zustell- oder Antwortprobleme verursachen — Postfach nutzen, das Sie kontrollieren
* Vorschau zeigt **From:** als Ihre angemeldete E-Mail; Reply-to mit **Send me a test email** prüfen
* Siehe [Preview & test](/features/preview-and-test)
# Start-Dialog-Tour (/de/getting-started/start-dialog)
Öffnen Sie das Add-on mit **Extensions → MailG for Gmail → 🚀 Start**. Ein 900×600-Dialog mit dem Titel **MailG for Gmail** öffnet sich.
## Bildschirme [#bildschirme]
| Bildschirm | So gelangen Sie dorthin | Zweck |
| ------------------ | ------------------------------------------------- | --------------------------------------------------- |
| Root (composer) | Standard nach dem Laden | Template + Empfänger wählen, Vorschau, senden |
| Create template | **New Template** | Name, Betreff, Body |
| Manage templates | Template-Symbol (Tooltip **Manage templates**) | Liste, bearbeiten, löschen |
| Update template | **Edit template** oder Zeilen-**Edit** | Bestehendes Template bearbeiten |
| Settings | Zahnrad in der Fußzeile (Tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | Keine gültige E-Mail-Spalte | Aufforderung, Kontakte oder Mock-Daten hinzuzufügen |
| API / sheet errors | Ladefehler | Retry-Hinweise |
## Root-Layout [#root-layout]
Drei Bereiche:
1. **Sidebar** (links) — Template, Recipient column, **More options**, Tracking, Branding, Quota
2. **Preview** (rechts) — From / To / Subject / body, Zeilennavigation, **Edit template**
3. **Footer** — Send-Button, Send-Menü, **Upgrade to Pro** (free), Settings, Help
## Sidebar-Steuerung (exakte Labels) [#sidebar-steuerung-exakte-labels]
* **New Template**
* **Template** (select) — Platzhalter `Select` oder `No templates found`
* **Recipient column** — Optionen wie `A - Email`; leer: `No valid email columns found.`
* **More options** — erweitert **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (standardmäßig an)
* **Remove branding** (paid)
* **Daily quota** — verbleibende Anzahl als „N left“ und Planzeile „Your plan sends up to TOTAL/day“
Free-Konten sehen auch **Leave a 5★ review for +N/day free** und **Or upgrade your plan**. Siehe [Daily quota & reviews](/help/daily-quota-and-reviews).
## Footer-Send-Steuerung [#footer-send-steuerung]
| Steuerung | Label |
| -------------- | ------------------------------------------------------------------------------------- |
| Primary button | **Send N email(s)** (oder **Send emails**, wenn count 0 ist) |
| Send menu | **Send me a test email** |
| Send menu | **Schedule send** |
| Upgrade (free) | **Upgrade to Pro** — Tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Gear | Tooltip **Send pacing** |
| Help | Tooltip **Help** — öffnet die In-Dialog-Checkliste |
### Need help?-Checkliste [#need-help-checkliste]
1. Template und Recipient column wählen
2. Jede Zeile mit den Pfeilen in der Vorschau ansehen
3. Zuerst eine Test-E-Mail an sich selbst senden
4. Auf Send klicken, um aus dem Sheet zu mergen
Buttons: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (falls verfügbar) | **Close**
## Leeres Blatt [#leeres-blatt]
Wenn MailG keine gültige E-Mail-Spalte findet:
* Titel: **No email address found in your sheet**
* Aktionen: **Close** | **Fill with mock data**
Mock-Daten legen Header `Email`, `First Name`, `Last Name`, `Company` an und erstellen ggf. **My First Template**.
## Fehlerbildschirme [#fehlerbildschirme]
| Titel | Wann |
| --------------------------------- | --------------------- |
| **Could not reach the MailG API** | API- / Netzwerkfehler |
| **Could not read your sheet** | Sheet-Lesefehler |
## Weiter [#weiter]
# Einrichtung (/de/getting-started/installation)
Zwei Schritte: Add-on installieren, dann in Sheets starten.
## MailG installieren [#mailg-installieren]
1. Öffnen Sie den [MailG-Eintrag im Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Klicken Sie auf **Install**.
3. Wählen Sie das Google-Konto, das die Installation besitzen soll.
4. Prüfen Sie die Berechtigungen und klicken Sie auf **Allow**.
Die Installation dauert in der Regel weniger als 15 Sekunden. Sie sollten eine Bestätigung sehen, dass das Add-on installiert wurde.
Wenn der Marketplace-Eintrag in Ihrer Region noch nicht live ist, nutzen Sie den Install-CTA auf [www.mailg.io](https://www.mailg.io) oder kontaktieren Sie [contact@mailg.io](mailto:contact@mailg.io).
## MailG in Google Sheets starten [#mailg-in-google-sheets-starten]
1. Öffnen Sie [Google Sheets](https://sheets.google.com) (aktualisieren Sie, falls Sheets bereits geöffnet war).
2. Warten Sie einige Sekunden, bis Extensions geladen sind (oft \~10–15 Sekunden).
3. Gehen Sie zu **Extensions → MailG for Gmail → 🚀 Start**.
Später können Sie **Extensions → MailG for Gmail → 🔄 Refresh Tracking** ausführen, um Open-Status zu synchronisieren, ohne den vollen Dialog zu öffnen.
## Installationsprobleme [#installationsprobleme]
Das sind typische Google-Workspace-Eigenheiten, keine MailG-Bugs:
### Ich sehe nie das Popup „installed successfully“ [#ich-sehe-nie-das-popup-installed-successfully]
Das passiert oft, wenn mehrere Google-Konten angemeldet sind und die Installation nicht das erwartete Konto verwendet hat.
**Workaround:** Öffnen Sie ein privates/Inkognito-Fenster, melden Sie sich nur mit dem Zielkonto an und installieren Sie erneut aus dem Marketplace.
### MailG erscheint nicht unter Extensions [#mailg-erscheint-nicht-unter-extensions]
1. Aktualisieren Sie die Tabelle.
2. Warten Sie etwa 10–15 Sekunden, bis Add-ons geladen sind.
3. Bestätigen Sie, dass Sie im selben Google-Konto sind, das MailG installiert hat.
4. Versuchen Sie eine andere Tabelle oder leeren Sie den Browser-Cache, falls es weiterhin fehlt.
## Self-hosted / eigene Deployments [#self-hosted--eigene-deployments]
Marketplace-Installationen sind vorkonfiguriert. Bei eigenem Deployment setzen Sie Apps-Script-Script-Properties:
| Property | Value |
| ------------- | ----------------------------------------- |
| `APP_URL` | Öffentliche HTTPS-URL Ihrer MailG-API |
| `APP_API_KEY` | Derselbe Schlüssel wie auf dem API-Server |
Das Add-on kann `localhost` von Googles Servern aus nicht erreichen — nutzen Sie einen Tunnel (Cloudflare Tunnel, ngrok usw.) für lokale Tests.
## Weiter [#weiter]
Fahren Sie mit dem [Mail-Merge-Tutorial](/getting-started/mail-merge-tutorial) fort.
# Mail-Merge-Tutorial (/de/getting-started/mail-merge-tutorial)
Diese Anleitung entspricht dem **MailG for Gmail**-Start-Dialog.
## 1. MailG öffnen [#1-mailg-öffnen]
**Extensions → MailG for Gmail → 🚀 Start**.
Wenn Sie **No email address found in your sheet** sehen, fügen Sie echte E-Mails hinzu oder klicken Sie **Fill with mock data** (erstellt Beispielzeilen und oft **My First Template**). Siehe [Start-Dialog-Tour](/getting-started/start-dialog).
## 2. Template erstellen oder auswählen [#2-template-erstellen-oder-auswählen]
1. Klicken Sie **New Template** (oder wählen Sie ein bestehendes unter **Template**).
2. Setzen Sie **Template Name** und **Email Subject** (Betreff wird heute **nicht** per Merge ersetzt).
3. Schreiben Sie den Body und fügen Sie [Merge-Tags](/features/merge-tags) über **Merge Tag** ein.
4. **Save Template**.
Body-Beispiel:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Kampagne konfigurieren [#3-kampagne-konfigurieren]
In der Sidebar:
1. **Recipient column** wählen (Zellen müssen gültige einzelne E-Mails sein, damit die UI sie zählt).
2. **More options** öffnen für **CC**, **BCC**, **Sender name**, **Reply to address**.
3. **Track emails** anlassen (Standard), wenn Sie Open-Status im Sheet wollen.
4. In einem Paid-Plan **Remove branding** aktivieren.
**Attachments** erscheint unter **More options**, aber Dateien werden beim Senden noch nicht angehängt. Verlinken Sie stattdessen auf Drive oder eine URL im Body.
## 4. Vorschau und Test [#4-vorschau-und-test]
1. Mit den Pfeilen vor/zurück durch Zeilen gehen.
2. **To:** und den gemergten Body prüfen (Betreff zeigt den rohen Template-Betreff).
3. Send-Menü → **Send me a test email**.
4. Posteingang prüfen.
Details: [Preview & test](/features/preview-and-test).
## 5. Senden oder planen [#5-senden-oder-planen]
* Primary button: **Send N email(s)**, wenn Empfänger gezählt werden.
* Oder Send-Menü → **Schedule send** → Datum/Uhrzeit wählen → **Schedule Send**.
Busy-Overlays: `Starting your campaign…` / Schedule-Bestätigungs-Toasts.
MailG fügt eine Kampagnen-Spalte wie `🚀 My Template (yyyy/MM/dd)` oder `🗓️ …` bei geplanter Sendung hinzu.
Zeilenstatus:
| Status | Bedeutung |
| ------------- | ------------------ |
| 🗓️ Scheduled | Wartet auf Start |
| ⏳ Sending… | Wird verarbeitet |
| ✉️ Sent | An Gmail übergeben |
| ⚠️ Failed | Fehler |
| 👀 Opened | Open-Pixel geladen |
## Häufige Fehler [#häufige-fehler]
* Betreff-Tags erwarten Personalisierung — vorerst nur Body
* Empfängerzellen mit mehreren kommagetrennten Adressen — die UI validiert **eine** E-Mail pro Zelle fürs Zählen
* Falsches Google-Konto vs. Installationskonto
* Daily quota erreicht — **Daily quota** in der Sidebar prüfen
## Tipps [#tipps]
* Footer-**Help**-Checkliste beim ersten Mal nutzen
* Mit 2–3 echten Zeilen nach Mock-Daten starten
* Nach Opens: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → Alert `Tracking info synced` (oder `No active campaigns`)
## Weiter [#weiter]
# Was ist MailG? (/de/getting-started/what-is-mailg)
MailG macht aus einem Google Sheet eine Mail-Merge-Kampagne. Jede Zeile ist ein Empfänger; Spaltenüberschriften werden zu Merge-Tags (doppelte geschweifte Klammern um den Header-Namen) im **email body**.
## Was Sie tun können [#was-sie-tun-können]
* Cloud-gestützte Templates erstellen (**Template Name**, **Email Subject**, Rich-Text-Body)
* Den **body** mit Merge-Tags aus Sheet-Headern personalisieren
* Zeilen in der Vorschau ansehen und **Send me a test email**
* **CC** / **BCC**, **Sender name**, **Reply to address** zuordnen
* **Schedule send** oder sofort senden
* **Track emails** mit Open-Status-Chips im Sheet
* **Send pacing** in kostenpflichtigen Plänen steuern
* **Remove branding** in kostenpflichtigen Plänen
* **Daily quota** beobachten (und optional einen kostenlosen Review-Bonus beanspruchen)
## Wie alles zusammenspielt [#wie-alles-zusammenspielt]
1. **Google Sheets add-on** — Dialog unter **MailG for Gmail**
2. **MailG API** — Templates, Kampagnen-Metadaten, Open-Tracking, Berechtigungen
3. **Ihr Gmail** — Nachrichten werden mit `GmailApp` vom autorisierten Konto gesendet
## Nächste Schritte [#nächste-schritte]
# Contattaci (/it/contact-us)
## Fatturazione e abbonamenti [#fatturazione-e-abbonamenti]
Puoi gestire la maggior parte delle modifiche all’abbonamento dal portale Stripe collegato tramite [pricing](https://app.mailg.io/pricing?lang=it). Per rimborsi o problemi di pagamento, scrivici via email.
## Tutto il resto [#tutto-il-resto]
Invia un’email a **[contact@mailg.io](mailto:contact@mailg.io)**.
Di solito rispondiamo entro un giorno lavorativo.
## Link utili [#link-utili]
* [Sito web](https://www.mailg.io)
* [Prezzi](https://app.mailg.io/pricing?lang=it)
* [Privacy](https://www.mailg.io/it/privacy)
* [Termini](https://www.mailg.io/it/terms)
* [Home documentazione](/)
# Documentazione MailG (/it)
MailG è un componente aggiuntivo per Google Sheets per il mail merge con Gmail. Apri **Extensions → MailG for Gmail → 🚀 Start**, crea un template, visualizza l’anteprima delle righe, poi invia o programma dall’account Gmail.
## Inizia da qui [#inizia-da-qui]
## Argomenti popolari [#argomenti-popolari]
## Link utili [#link-utili]
* Sito: [www.mailg.io](https://www.mailg.io)
* Documentazione: [docs.mailg.io/it](https://docs.mailg.io/it)
* Prezzi: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=it)
* Contatto: [contact@mailg.io](mailto:contact@mailg.io)
## Per assistenti IA / LLM [#per-assistenti-ia--llm]
Preferite questi endpoint leggibili dalle macchine invece di fare scraping dell’HTML:
* [Agents hub](https://www.mailg.io/it/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/it/help/faq)
## Installazione e apertura [#installazione-e-apertura]
**Come apro MailG?**\
**Extensions → MailG for Gmail → 🚀 Start**. Vedi [Installazione](/getting-started/installation).
**No email address found in your sheet**\
Aggiungi email a una colonna, oppure clicca **Fill with mock data**. Vedi [Tour della finestra di avvio](/getting-started/start-dialog).
**Could not reach the MailG API**\
Controlla rete / URL API (self-hosted: `APP_URL` + `APP_API_KEY`). Riapri la finestra dopo la correzione.
## Invio [#invio]
**Le email non partono**\
Controlla **Daily quota**, le autorizzazioni Gmail e che le celle **Recipient column** contengano email singole valide. Gli errori mostrano **⚠️ Failed**.
**I merge tag nell’oggetto funzionano?**\
Non ancora. Solo il **corpo** viene sostituito. Mantieni un oggetto fisso o metti la personalizzazione nel corpo. Vedi [Merge tag](/features/merge-tags).
**Posso allegare file?**\
Il selettore **Attachments** esiste sotto **More options**, ma i file non vengono ancora allegati all’invio. Usa i link.
**Come interrompo una campagna?**\
[Interrompere una campagna](/features/stopping-a-campaign) — cancella gli stati inviabili sulle righe rimanenti.
**Perché sono limitato su Professional?**\
MailG può consentire fino a 1.500/giorno, ma `@gmail.com` gratuito è spesso limitato intorno a 500 da Google.
## Tracking [#tracking]
**Il foglio dice ancora Sent dopo un’apertura**\
**🔄 Refresh Tracking** → aspettati `Tracking info synced`. Alcuni client non caricano mai le immagini.
**Click?**\
Non tracciati. **Track emails** = solo aperture.
## Quota e fatturazione [#quota-e-fatturazione]
Vedi [Daily quota e recensioni](/help/daily-quota-and-reviews) e [Account e fatturazione](/help/account-and-billing).
**Schedule send è a pagamento?**\
No. Il piano a pagamento sblocca quote più alte, modalità di pacing e **Remove branding**.
## Risoluzione problemi [#risoluzione-problemi]
Per correzioni passo passo (errori API, foglio vuoto, pulsante di invio disabilitato, righe fallite, tracking, quota, programmazione non differita), vedi [Risoluzione problemi](/help/troubleshooting).
Toast comuni che potresti vedere:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Ancora bloccato? [#ancora-bloccato]
[Risoluzione problemi](/help/troubleshooting) · Docs [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Risoluzione problemi (/it/help/troubleshooting)
Correzioni rapide per i messaggi e gli stati che vedi nel componente aggiuntivo.
## La finestra non si carica [#la-finestra-non-si-carica]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
La finestra di avvio non ha potuto chiamare il backend MailG.
* Conferma di essere online
* Installazioni Marketplace: attendi un momento e riapri **🚀 Start**
* Self-hosted: controlla le proprietà Apps Script `APP_URL` (HTTPS pubblico) e `APP_API_KEY`
* Il componente aggiuntivo non può usare `localhost` — usa un tunnel per i test API locali
### Could not read your sheet [#could-not-read-your-sheet]
MailG non è riuscito a leggere il foglio di calcolo attivo.
* Assicurati che una scheda del foglio sia aperta (non solo l’editor Apps Script)
* Ricarica il foglio di calcolo, poi riapri la finestra
* Conferma di avere accesso in modifica al file
### Loading… non termina mai [#loading-non-termina-mai]
Chiudi la finestra, aggiorna Sheets, attendi \~15 secondi per Extensions, poi **🚀 Start** di nuovo.
## Foglio vuoto [#foglio-vuoto]
**No email address found in your sheet**
MailG ha bisogno di almeno una colonna con indirizzi email validi.
* Aggiungi email sotto un’intestazione, oppure clicca **Fill with mock data**
* I mock data creano `Email`, `First Name`, `Last Name`, `Company` e spesso **My First Template**
Vedi [Tour della finestra di avvio](/getting-started/start-dialog).
## Template [#template]
* Creazione: `Creating Template...` → `Template created successfully!` o `Failed to create template! Try again later.`
* Aggiornamento: `Updating template...`
* Errori di eliminazione: `Failed to delete template. Try again later`
Vedi [Template](/features/templates).
## Problemi di invio [#problemi-di-invio]
### Pulsante Send disabilitato / Send emails senza conteggio [#pulsante-send-disabilitato--send-emails-senza-conteggio]
* Seleziona un **Template**
* Seleziona una **Recipient column** con **email singole** valide per cella
* Toast di blocco che potresti vedere: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### La campagna non parte [#la-campagna-non-parte]
Toast: `Failed to create campaign. Please try again.`
* Riprova una volta
* Controlla che **Daily quota** non sia 0
* Conferma la connettività API (vedi sopra)
### Le righe mostrano ⚠️ Failed [#le-righe-mostrano-️-failed]
Quella riga ha avuto un errore di invio (indirizzo non valido, rifiuto Gmail, quota transitoria, ecc.). Correggi i dati e avvia una nuova campagna per le righe rimanenti, oppure vedi [Interrompere una campagna](/features/stopping-a-campaign).
### L’email di test fallisce [#lemail-di-test-fallisce]
* `Configure your preview first` — scegli template + destinatario affinché l’anteprima abbia un To
* `Failed to send test email. Please check your email settings.` — riautorizza Gmail se necessario, poi riprova
## Tracking [#tracking]
* Le aperture richiedono il caricamento delle immagini remote da parte del destinatario
* Esegui **🔄 Refresh Tracking** — aspettati `Tracking info synced` o `No active campaigns`
* Lo stato **👀 Opened** compare solo quando il pixel viene caricato
Vedi [Email tracking](/features/email-tracking).
## Quota e branding [#quota-e-branding]
* **N left** nella sidebar è `min(MailG remaining, Gmail remaining)`
* `@gmail.com` gratuito è spesso limitato intorno a 500/giorno da Google anche su Professional
* Watermark ancora presente dopo il pagamento → l’email del checkout deve corrispondere all’account Sheets; riapri la finestra
Vedi [Daily quota e recensioni](/help/daily-quota-and-reviews) e [Remove branding](/features/remove-branding).
## La programmazione non ha differito [#la-programmazione-non-ha-differito]
Orari a meno di circa **15 secondi** nel futuro vengono trattati come invio **immediato** (colonna 🚀), non come programmazione differita 🗓️. Scegli un orario più lontano.
## Ancora bloccato? [#ancora-bloccato]
FAQ completa: [FAQ](/help/faq) · Email [contact@mailg.io](mailto:contact@mailg.io) · Sito [app.mailg.io/help](https://www.mailg.io/it/help)
# Quota giornaliera e recensioni (/it/help/daily-quota-and-reviews)
La sidebar root mostra la capacità di invio quando i dati dell’account sono caricati.
## Blocco Daily quota [#blocco-daily-quota]
Interfaccia esatta:
* Etichetta: **Daily quota**
* Rimanente: **N left**
* Riga del piano: **Your plan sends up to TOTAL/day**
**Remaining** è il minimo tra:
1. Quota rimanente del piano MailG per il giorno
2. Quota di invio Gmail rimanente per l’account
Quindi puoi essere limitato da Gmail anche quando MailG mostra ancora margine sulla carta. Vedi anche [Account e fatturazione](/help/account-and-billing).
## CTA piano gratuito [#cta-piano-gratuito]
Quando non sei abbonato, la sidebar può mostrare:
* **Leave a 5★ review for +N/day free** (bonus predefinito **+50/day** quando l’API non specifica diversamente)
* **Or upgrade your plan**
Cliccando il CTA recensione si apre **Free Quota upgrade**:
* Titolo: **Free Quota upgrade**
* Corpo: lascia una recensione a 5 stelle per ottenere un upgrade gratuito della quota di **+N emails/day**
* Pulsanti: **Not now** | **Leave a 5★ review**
Se l’URL recensione non è configurato, **Leave a 5★ review** resta disabilitato — usa **Upgrade to Pro** / pricing.
## Passa a Pro [#passa-a-pro]
Pulsante nel footer (account gratuiti): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
Corrisponde a ciò che i piani a pagamento sbloccano oggi nel prodotto.
## Correlati [#correlati]
* [Remove branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Account e fatturazione (/it/help/account-and-billing)
La fatturazione MailG è collegata all’**email del tuo account Google** in Sheets. Completa sempre il checkout con lo stesso indirizzo affinché le quote si sblocchino nel componente aggiuntivo.
## Piani e quote giornaliere [#piani-e-quote-giornaliere]
| Piano | Quota giornaliera | Note |
| ------------ | ----------------- | ------------------------------------------------ |
| Free | 50 | Merge di base, tracking aperture, programmazione |
| Personal | 250 | Piano popolare per elenchi in crescita |
| Professional | 1.500 | Quota ricorrente più alta |
| Lifetime | 1.500 | Acquisto una tantum |
Prezzi e intervalli sono elencati su [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=it) (EUR e USD).
I diritti a pagamento sbloccano anche:
* [Send pacing](/features/send-pacing) non predefinito (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Il volume di invio effettivo è `min(MailG daily quota, Gmail remaining quota)`.
## Come fare l’upgrade [#come-fare-lupgrade]
1. Apri [pricing](https://app.mailg.io/pricing?lang=it) (collegato anche dal componente aggiuntivo tramite **Upgrade to Pro**).
2. Scegli un piano e completa Stripe Checkout con l’email Google Sheets.
3. Riapri MailG in Sheets affinché l’aggiornamento account rilevi il nuovo limite.
## Cancella o aggiorna un abbonamento [#cancella-o-aggiorna-un-abbonamento]
Puoi cancellare o modificare l’abbonamento dal portale clienti Stripe collegato al flusso abbonamento / pricing.
* Se cancelli a metà ciclo, le funzionalità Premium restano attive fino alla fine del periodo pagato
* Non verrai addebitato di nuovo dopo l’effettiva cancellazione
## Rimborsi [#rimborsi]
Se cancelli un abbonamento Premium entro **30 giorni** dall’acquisto, puoi richiedere un rimborso completo scrivendo a [contact@mailg.io](mailto:contact@mailg.io).
## Fatture [#fatture]
Stripe invia ricevute via email per i pagamenti riusciti. Puoi anche scaricare le fatture dal portale clienti Stripe usato per la gestione dell’abbonamento.
## Estratti FAQ [#estratti-faq]
**MailG è incluso in Google Workspace?**\
No. MailG è indipendente da Google. Un abbonamento Workspace non include MailG.
**Quali metodi di pagamento sono accettati?**\
Carte principali, Google Pay e Apple Pay tramite Stripe. PayPal non è supportato.
**Ho pagato ma vedo ancora il limite gratuito / watermark**\
Quasi sempre una discrepanza di email. Conferma email checkout = email account Sheets, poi riapri il componente aggiuntivo. Se persiste, contatta l’assistenza con entrambe le email.
**Perché Gmail gratuito è limitato a circa 500 email al giorno?**\
MailG Professional consente fino a 1.500 email al giorno, ma Google stesso limita gli account `@gmail.com` gratuiti a circa 500 invii al giorno. Gli account Google Workspace possono andare più in alto. È un limite del provider Gmail, non di MailG.
# Pianificazione campagne (/it/features/campaign-scheduling)
Usa **Schedule send** quando vuoi che MailG inizi più tardi. Disponibile sui piani gratuiti e a pagamento.
## Come programmare [#come-programmare]
1. Configura template e destinatari affinché il pulsante di invio sia abilitato.
2. Apri il menu di invio (chevron) → **Schedule send**.
3. Titolo finestra: **Schedule send**
4. Descrizione: `Pick date & time to schedule sending`
5. Riga di riepilogo: programmazione di N email con invio a partire dalla data/ora scelta
6. Usa il selettore data più **Hour** / **Minute** (placeholder `Hour`, `Min`).
7. Conferma con **Schedule Send** (o **Cancel**).
Il suggerimento predefinito è circa **60 minuti** nel futuro, arrotondato al passo successivo di **15 minuti**.
## Immediato vs programmato [#immediato-vs-programmato]
Orari a meno di circa **15 secondi** nel futuro vengono trattati come invio **immediato** (intestazione colonna 🚀), non come programmazione differita 🗓️. Scegli un orario più lontano se ti serve l’invio differito.
Toast di validazione: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Toast di successo: campagna programmata; N email inizieranno all’orario scelto.
## Colonna del foglio [#colonna-del-foglio]
Le campagne programmate creano un’intestazione colonna come:
```text
🗓️ Template name (yyyy/MM/dd)
```
Gli invii immediati usano 🚀 invece di 🗓️.
Le righe partono come **🗓️ Scheduled**, poi passano a **⏳ Sending…** quando la coda viene eseguita.
## Dopo la programmazione [#dopo-la-programmazione]
* Mantieni il foglio di calcolo accessibile all’account Google che possiede il componente aggiuntivo
* Tracking e pacing si applicano comunque quando inizia l’invio
* Nessuna interfaccia **Manage Schedule** — vedi [Interrompere una campagna](/features/stopping-a-campaign)
## Correlati [#correlati]
* [Anteprima e test](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Destinatari multipli (/it/features/multiple-recipients)
Puoi aggiungere destinatari in copia per riga con colonne dedicate nel foglio.
## Colonna destinatari (A) [#colonna-destinatari-a]
Seleziona **Recipient column** nella sidebar.
Per il conteggio del pulsante di invio e la validazione delle colonne, MailG considera valida una cella quando contiene un **unico** indirizzo email. Preferisci un indirizzo To principale per riga.
## Colonne CC e BCC [#colonne-cc-e-bcc]
1. Aggiungi colonne nel foglio (ad esempio `CC` e `BCC`).
2. Inserisci un’email (o un elenco accettato da Gmail) nella cella.
3. Apri **More options** e mappa **CC** / **BCC**.
4. All’invio, quei valori vengono passati a Gmail.
Il riquadro di anteprima mostra solo **From**, **To**, **Subject** e corpo. **Non** visualizza le righe CC/BCC anche se mappate. Conferma con **Send me a test email** se devi verificare la consegna CC/BCC.
## Quote: MailG vs Gmail [#quote-mailg-vs-gmail]
* La **quota giornaliera MailG** conta le **righe di campagna** elaborate.
* I **limiti di invio Gmail** contano i **destinatari** (indirizzi To + CC + BCC che Gmail accetta in quell’invio).
Puoi comunque raggiungere il limite Gmail mentre la quota MailG resta disponibile.
## Suggerimenti [#suggerimenti]
* Preferisci **BCC** quando i destinatari non devono vedersi a vicenda
* Lascia CC/BCC non mappati quando non servono
* Valida gli indirizzi prima di un invio massivo
# Attachments (/it/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Panoramica delle funzionalità (/it/features/features-overview)
Cosa supporta oggi il componente aggiuntivo:
| Funzionalità | Documentazione |
| ----------------------------------------------- | ------------------------------------------------------------- |
| Finestra di avvio / foglio vuoto / mock data | [Tour della finestra di avvio](/getting-started/start-dialog) |
| Template (crea / gestisci / modifica / elimina) | [Template](/features/templates) |
| Merge tag nel **corpo** | [Merge tag](/features/merge-tags) |
| Barra degli strumenti rich-text | [Email rich-text](/features/rich-text-emails) |
| Link (non incorporamenti immagine) | [Immagini](/features/images) |
| Anteprima + email di test | [Anteprima e test](/features/preview-and-test) |
| Schedule send | [Programmazione campagne](/features/campaign-scheduling) |
| Send pacing (a pagamento) | [Send pacing](/features/send-pacing) |
| Colonne CC / BCC | [Destinatari multipli](/features/multiple-recipients) |
| Track emails | [Email tracking](/features/email-tracking) |
| Sender name e reply-to | [Mittente personalizzato](/features/customized-sender) |
| Remove branding (a pagamento) | [Remove branding](/features/remove-branding) |
| Interrompi righe rimanenti | [Interrompere una campagna](/features/stopping-a-campaign) |
| Daily quota + bonus recensione | [Daily quota e recensioni](/help/daily-quota-and-reviews) |
## Gratuito vs a pagamento [#gratuito-vs-a-pagamento]
Il piano a pagamento sblocca:
* [Send pacing](/features/send-pacing) non predefinito
* [Remove branding](/features/remove-branding)
* [Quote giornaliere](/help/account-and-billing) più elevate
**Schedule send**, **Track emails** e gli strumenti per i template funzionano senza upgrade a pagamento.
## Limiti noti (in modo trasparente) [#limiti-noti-in-modo-trasparente]
| Argomento | Stato nel prodotto |
| ------------------------- | ----------------------------------------------------- |
| Merge tag nell’oggetto | Non applicati all’invio — solo il corpo |
| Colonna Attachments | Solo interfaccia — non allegati all’invio |
| Incorporamenti immagine | Nessun controllo nell’editor — usa i link |
| Righe CC/BCC in anteprima | Non mostrate nell’interfaccia di anteprima |
| Manage Schedule / Pause | Non disponibile — soluzione alternativa con gli stati |
## In arrivo [#in-arrivo]
Link di disiscrizione, click tracking, posti team condivisi e un’interfaccia dedicata per la gestione delle campagne quando saranno rilasciati.
# Tracciamento e-mail (/it/features/email-tracking)
MailG può registrare le aperture con un piccolo pixel invisibile.
## Attiva il tracking [#attiva-il-tracking]
Nella sidebar, lascia **Track emails** attivo (predefinito attivo per i nuovi job).
Tooltip: `Track emails opened with a tiny pixel`
L’icona di aiuto apre **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Pulsante: **Got it**
## Stati nel foglio [#stati-nel-foglio]
| Stato | Significato |
| ------------- | ---------------------------------- |
| 🗓️ Scheduled | In attesa dell’avvio programmato |
| ⏳ Sending… | Attualmente in elaborazione |
| ✉️ Sent | Consegnato a Gmail per quella riga |
| ⚠️ Failed | Errore di invio per quella riga |
| 👀 Opened | Pixel di apertura caricato |
Le intestazioni colonna campagna assomigliano a `🚀 Template name (yyyy/MM/dd)` o `🗓️ …` se programmata.
## Aggiorna tracking [#aggiorna-tracking]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Alert Apps Script:
* `Tracking info synced`
* `No active campaigns`
## Limitazioni [#limitazioni]
* Il client deve caricare le immagini remote
* I proxy privacy possono nascondere le aperture
* Solo aperture — non click sui link
## Correlati [#correlati]
* [Programmazione campagne](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Tag di unione (/it/features/merge-tags)
I merge tag permettono a ogni destinatario di ricevere un **corpo** personalizzato. Un tag è l’**intestazione di colonna esatta** racchiusa tra doppie parentesi graffe.
## Sintassi [#sintassi]
Se il foglio ha una colonna denominata `First Name`, usa:
```text
{{First Name}}
```
Esempio di corpo:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Dove funzionano i merge tag oggi [#dove-funzionano-i-merge-tag-oggi]
| Campo | Sostituito all’invio? |
| -------------------- | -------------------------------------------------------- |
| Corpo email | **Sì** — variabili inserite per riga |
| Oggetto email | **No** — l’oggetto viene inviato così com’è nel template |
| Corpo in anteprima | **Sì** — per la riga attiva |
| Oggetto in anteprima | **No** — mostra l’oggetto grezzo del template |
Metti la personalizzazione nel corpo finché non sarà disponibile il merge nell’oggetto.
## Inserire i tag [#inserire-i-tag]
Nella barra degli strumenti dell’editor, apri **Merge Tag**. Elenca le intestazioni del foglio attivo. Stato vuoto: `No sheet columns found`.
Il testo inserito usa doppie parentesi graffe attorno al nome della colonna.
## Regole pratiche [#regole-pratiche]
* Le intestazioni distinguono maiuscole/minuscole (`Name` ≠ `name`)
* Le celle vuote vengono inserite come stringhe vuote
* Puoi riutilizzare lo stesso tag più volte nel corpo
* Destinatario / CC / BCC si scelgono sotto **More options**, non tramite merge tag
## Avanti [#avanti]
Vedi [Email rich-text](/features/rich-text-emails) e [Anteprima e test](/features/preview-and-test).
# E-mail rich text (/it/features/rich-text-emails)
I template MailG usano un editor rich-text TipTap. L’HTML che produce è ciò che Gmail consegna.
Placeholder del corpo: `Write your email…`
## Inventario barra degli strumenti (interfaccia esatta) [#inventario-barra-degli-strumenti-interfaccia-esatta]
| Gruppo | Controlli |
| --------------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Famiglia font | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Dimensione font | **10pt** … **24pt** (preset nella barra) |
| Stili | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Colore | Campioni predefiniti + selettore colore nativo + **Reset** |
| Allineamento | **Align left**, **Align center**, **Align right**, **Justify** |
| Elenchi | **Bullet list**, **Numbered list** |
| Link | **Insert link** — placeholder URL `https://example.com`, poi **Apply** (e unlink) |
| Cronologia | **Undo**, **Redo** |
## Non presenti nell’editor [#non-presenti-nelleditor]
Queste funzionalità TipTap sono disabilitate / assenti:
* Titoli, codice, blocco codice, blockquote, linea orizzontale
* Inserimento immagine / selettore media Drive — vedi [Immagini](/features/images)
## Collegamenti ipertestuali [#collegamenti-ipertestuali]
Usa **Insert link** per l’URL e il testo visibile. Preferisci testo del link chiaro rispetto agli URL grezzi.
## Suggerimenti [#suggerimenti]
* Usa **Merge Tag** invece di digitare le parentesi graffe a mano
* Visualizza l’anteprima di diverse righe prima dell’invio — vedi [Anteprima e test](/features/preview-and-test)
* Evita markup enorme incollato da Word/Docs; riapplica la formattazione in MailG per un HTML più pulito
# Rimuovere il branding MailG (/it/features/remove-branding)
Le campagne gratuite possono includere un piccolo watermark MailG nel footer dell’email. Gli abbonati a pagamento possono disattivarlo.
## Come rimuovere il branding [#come-rimuovere-il-branding]
1. Conferma di avere un piano a pagamento attivo (Personal, Professional o Lifetime).
2. Apri la sidebar della campagna.
3. Attiva **Remove branding**.
4. Visualizza l’anteprima di una riga per confermare che il watermark è sparito, poi invia.
Se il branding compare ancora dopo il pagamento:
* Assicurati che il checkout abbia usato la **stessa email** del tuo account Google Sheets
* Riapri il componente aggiuntivo per aggiornare i diritti dall’API
* Contatta [contact@mailg.io](mailto:contact@mailg.io) con l’email del tuo account Google
Vedi [Account e fatturazione](/help/account-and-billing).
# Immagini (/it/features/images)
L’editor MailG **non ha un pulsante di inserimento immagine** né un selettore media Google Drive. L’estensione Image di TipTap non è abilitata.
## Cosa puoi fare oggi [#cosa-puoi-fare-oggi]
Usa **Insert link** nella barra degli strumenti:
1. Ospita l’immagine (o il file) su un URL pubblico, oppure condividi un link Drive.
2. Seleziona il testo (o posiziona il cursore) → **Insert link**.
3. Incolla l’URL (placeholder `https://example.com`) → **Apply**.
I destinatari aprono il link per visualizzare l’immagine o il file. L’editor non incorpora tag `![]()
` per te.
## Suggerimenti [#suggerimenti]
* Preferisci file piccoli e testo del link chiaro («View screenshot»)
* I link che richiedono l’accesso falliranno per i destinatari
* Conferma con **Send me a test email**
## In arrivo [#in-arrivo]
Un incorporamento immagine di prima classe / selettore Drive potrebbe arrivare in seguito. Fino ad allora, i collegamenti ipertestuali sono il percorso supportato.
# Modelli (/it/features/templates)
I template memorizzano l’oggetto e il corpo rich-text che riutilizzi nelle campagne. Sono salvati nella MailG API per il tuo account Google.
## Crea un template [#crea-un-template]
1. Nella schermata root, clicca **New Template**.
2. Compila:
* **Template Name**
* **Email Subject**
* Corpo (editor rich — vedi [Email rich-text](/features/rich-text-emails))
3. Clicca **Save Template** (mostra **Saving...** durante l’operazione).
Toast:
* Caricamento: `Creating Template...`
* Successo: `Template created successfully!`
* Errore: `Failed to create template! Try again later.`
Template demo da **Fill with mock data**: nome **My First Template**, oggetto `I found a mail merge tool for Gmail`.
## Gestisci i template [#gestisci-i-template]
Apri l’icona template accanto al select del template (tooltip **Manage templates**).
Colonne della tabella:
| Colonna | Contenuto |
| ----------------- | ----------------- |
| **Name** | Nome del template |
| **Email Subject** | Riga dell’oggetto |
| **Created At** | Data di creazione |
| **Actions** | Menu riga |
Menu riga: **Edit** | **Delete**
Footer: **Back**
Toast di eliminazione: deleting template NAME → template NAME deleted successfully (o un messaggio di errore).
## Modifica un template [#modifica-un-template]
Apri **Edit** dalla gestione, oppure clicca **Edit template** nella barra degli strumenti dell’anteprima.
Stessi campi della creazione. **Save Template** aggiorna il template.
Il flusso di aggiornamento mostra un toast di caricamento (`Updating template...`). Resta sul modulo finché non termina, poi usa **Cancel** o **Back** se non vieni reindirizzato automaticamente.
## Oggetto vs corpo [#oggetto-vs-corpo]
* Il **corpo** supporta i [merge tag](/features/merge-tags) — vengono inseriti per riga al momento dell’invio.
* **Email Subject** viene inviato così com’è oggi (i merge tag nell’oggetto **non** vengono ancora sostituiti). Metti la personalizzazione nel corpo, oppure usa un oggetto fisso.
## Correlati [#correlati]
* [Anteprima e test](/features/preview-and-test)
* [Tour della finestra di avvio](/getting-started/start-dialog)
# Anteprima e test (/it/features/preview-and-test)
Il riquadro di anteprima (lato destro della finestra root) mostra come appare un messaggio per la riga attiva del foglio.
## Cosa mostra l’anteprima [#cosa-mostra-lanteprima]
| Campo | Contenuto |
| ------------ | ---------------------------------------------------------------------------------------- |
| **From:** | Email dell’account Google con cui hai effettuato l’accesso |
| **To:** | Valore dalla **Recipient column** per la riga attiva, oppure `Select a recipient column` |
| **Subject:** | Oggetto del template così com’è (senza sostituzione merge) |
| Corpo | Corpo del template con merge tag applicati per quella riga |
Se **Remove branding** è disattivato, l’anteprima include il footer watermark MailG (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## Cosa non viene mostrato [#cosa-non-viene-mostrato]
* Le righe **CC** / **BCC** non vengono renderizzate nell’interfaccia di anteprima (anche se mappate sotto **More options**). Vengono comunque applicate all’invio.
* I valori della colonna Attachments non compaiono in anteprima.
## Navigare tra le righe [#navigare-tra-le-righe]
Barra degli strumenti dell’anteprima:
* **Edit template** — apre la schermata di aggiornamento template
* **Previous recipient** / **Next recipient** — spostati tra le righe dati (i tooltip possono includere il numero di riga del foglio; l’intestazione è la riga 1, quindi il primo contatto è la riga 2)
## Inviami un’email di prova [#inviami-unemail-di-prova]
1. Configura template + recipient column affinché l’anteprima sia valida.
2. Apri il menu di invio (chevron) → **Send me a test email**.
3. Overlay di attività: `Sending test email…`
4. Toast di successo: `Test email sent successfully. Check your inbox.`
5. Toast di errore: `Failed to send test email. Please check your email settings.`
6. Blocco se l’anteprima è incompleta: `Configure your preview first`
Il test va alla casella di posta del **tuo** account Google, usando il corpo con merge della riga attiva in anteprima.
## Suggerimenti [#suggerimenti]
* Scorri diverse righe con le frecce prima di un invio completo
* Conferma branding / assenza di branding in anteprima
* Testa sempre prima di **Schedule send** o di un ampio **Send N email(s)**
## Correlati [#correlati]
* [Merge tag](/features/merge-tags)
* [Tutorial mail merge](/getting-started/mail-merge-tutorial)
# Ritmo di invio (/it/features/send-pacing)
Send pacing aggiunge un ritardo tra i messaggi così una campagna grande non esce dal tuo account in un unico burst.
**Steady pace** e **Jittered gaps** richiedono un abbonamento MailG a pagamento attivo. Gli account gratuiti usano solo **Burst send**.
## Dove configurare [#dove-configurare]
Apri l’ingranaggio nel footer (tooltip **Send pacing**). Intestazione schermata: **Send pacing**.
Sotto **Dispatch mode**, scegli come distanziare le email. **Gap between emails** è impostato in **secondi** (0–60). Gli account gratuiti vedono **Pro features** e il testo bloccato: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Predefinito per i nuovi job: **Burst send**, gap **10s** (il gap viene ignorato finché resti in burst).
## Modalità [#modalità]
| Modalità (etichetta UI) | Comportamento |
| ---------------------------- | ---------------------------------------------------------- |
| **Burst send** (predefinito) | Invia il più rapidamente possibile entro i limiti di quota |
| **Steady pace** | Attende un gap fisso tra ogni email |
| **Jittered gaps** | Attende un gap casuale tra 0 e il massimo scelto |
## Perché usare il pacing [#perché-usare-il-pacing]
* Ridurre il rischio di sembrare un burst improvviso per i provider di posta
* Distribuire un elenco lungo in una finestra di invio più tranquilla
* Restare entro le zone di comfort Gmail per il tuo tipo di account
## Note [#note]
* Il pacing è un’impostazione di campagna salvata con il job — i nuovi invii usano la configurazione attuale
* Un gap lungo su un elenco grande aumenta sensibilmente la durata totale della campagna
* La velocità effettiva resta limitata dalla quota giornaliera MailG **e** dalla quota di invio Gmail rimanente
* Alcuni strumenti concorrenti esprimono il ritardo in minuti — MailG usa i **secondi**
## Correlati [#correlati]
* [Interrompere una campagna](/features/stopping-a-campaign) se un gap era stato impostato troppo alto a metà esecuzione
* [Account e fatturazione](/help/account-and-billing)
# Interrompere una campagna (/it/features/stopping-a-campaign)
MailG non offre ancora una schermata dedicata **Manage Schedule**, **Abort** o **Pause** come alcuni concorrenti. Puoi comunque impedire l’invio delle righe **rimanenti**.
## Come l’invio decide cosa elaborare [#come-linvio-decide-cosa-elaborare]
Il ciclo di invio elabora solo le righe il cui stato nella colonna campagna è ancora inviabile:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
Le righe già contrassegnate **✉️ Sent**, **⚠️ Failed** o **👀 Opened** vengono saltate.
## Interrompi le righe rimanenti (soluzione alternativa onesta) [#interrompi-le-righe-rimanenti-soluzione-alternativa-onesta]
Agisci rapidamente su una campagna grande:
1. Apri il foglio di calcolo.
2. Nella colonna stato campagna, cancella o modifica lo stato sulle righe che **non** devono essere inviate (ad esempio elimina il valore della cella, oppure imposta un’etichetta non inviabile come `Stopped`).
3. Lascia invariate le righe già **✉️ Sent** — quei messaggi sono già partiti.
Le righe che cancelli/modifichi non corrisponderanno più agli stati inviabili, quindi la coda le salterà al passo successivo.
I messaggi Gmail già usciti dall’account non possono essere annullati da MailG. L’interruzione protegge solo le righe non ancora elaborate.
## Campagne programmate non ancora avviate [#campagne-programmate-non-ancora-avviate]
Se ogni riga è ancora **🗓️ Scheduled** e l’orario di avvio non è arrivato, cancellare quegli stati (o la colonna campagna) impedisce alla coda di prelevarle quando arriva il momento.
Se non sei sicuro, contatta [contact@mailg.io](mailto:contact@mailg.io) con l’URL del foglio di calcolo e i dettagli della campagna.
## Correlati [#correlati]
* [Programmazione campagne](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Mittente personalizzato (/it/features/customized-sender)
Per impostazione predefinita, Gmail invia dall’account Google che ha autorizzato MailG. Puoi comunque personalizzare come appare il tuo nome e dove arrivano le risposte.
## Nome mittente [#nome-mittente]
1. Apri **More options** nella sidebar della campagna.
2. Imposta **Sender name** (placeholder `John Doe (Optional)`).
3. I destinatari vedono quel nome visualizzato nella casella di posta (secondo le regole usuali di presentazione di Gmail).
## Indirizzo di risposta [#indirizzo-di-risposta]
Imposta **Reply to address** (placeholder `john@doe.com (Optional)`) se le risposte devono andare altrove rispetto all’account di invio.
## Note [#note]
* L’indirizzo From sottostante resta l’account Gmail autorizzato — non puoi falsificare un’altra casella
* Indirizzi reply-to non validi possono causare problemi di consegna o risposta — usa una casella che controlli
* L’anteprima mostra **From:** come la tua email con cui hai effettuato l’accesso; conferma il reply-to con **Send me a test email**
* Vedi [Anteprima e test](/features/preview-and-test)
# Tour della finestra di avvio (/it/getting-started/start-dialog)
Apri il componente aggiuntivo con **Extensions → MailG for Gmail → 🚀 Start**. Si apre una finestra 900×600 intitolata **MailG for Gmail**.
## Schermate [#schermate]
| Schermata | Come ci arrivi | Scopo |
| ------------------- | ------------------------------------------------ | ----------------------------------------------- |
| Root (composer) | Predefinita dopo il caricamento | Scegli template + destinatari, anteprima, invio |
| Create template | **New Template** | Nome, oggetto, corpo |
| Manage templates | Icona template (tooltip **Manage templates**) | Elenco, modifica, elimina |
| Update template | **Edit template** o **Edit** sulla riga | Modifica un template esistente |
| Settings | Ingranaggio nel footer (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | Nessuna colonna email valida | Invito ad aggiungere contatti o mock data |
| Errori API / foglio | Errore di caricamento | Indicazioni per riprovare |
## Layout root [#layout-root]
Tre zone:
1. **Sidebar** (sinistra) — template, recipient column, **More options**, tracking, branding, quota
2. **Preview** (destra) — From / To / Subject / body, navigazione righe, **Edit template**
3. **Footer** — pulsante di invio, menu di invio, **Upgrade to Pro** (gratuito), settings, help
## Controlli sidebar (etichette esatte) [#controlli-sidebar-etichette-esatte]
* **New Template**
* **Template** (select) — placeholder `Select` o `No templates found`
* **Recipient column** — opzioni come `A - Email`; vuoto: `No valid email columns found.`
* **More options** — espande **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (attivo per impostazione predefinita)
* **Remove branding** (a pagamento)
* **Daily quota** — conteggio rimanente come «N left» e riga del piano «Your plan sends up to TOTAL/day»
Gli account gratuiti vedono anche **Leave a 5★ review for +N/day free** e **Or upgrade your plan**. Vedi [Daily quota e recensioni](/help/daily-quota-and-reviews).
## Controlli di invio nel footer [#controlli-di-invio-nel-footer]
| Controllo | Etichetta |
| ------------------- | ------------------------------------------------------------------------------------- |
| Pulsante principale | **Send N email(s)** (o **Send emails** quando il conteggio è 0) |
| Menu di invio | **Send me a test email** |
| Menu di invio | **Schedule send** |
| Upgrade (gratuito) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Ingranaggio | tooltip **Send pacing** |
| Help | tooltip **Help** — apre la checklist nella finestra |
### Checklist Need help? [#checklist-need-help]
1. Scegli un template e una recipient column
2. Visualizza l’anteprima di ogni riga con le frecce
3. Invia prima un’email di test a te stesso
4. Clicca Send per fare il merge dal foglio
Pulsanti: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (se disponibile) | **Close**
## Foglio vuoto [#foglio-vuoto]
Se MailG non trova una colonna email valida:
* Titolo: **No email address found in your sheet**
* Azioni: **Close** | **Fill with mock data**
I mock data creano le intestazioni `Email`, `First Name`, `Last Name`, `Company` e possono generare **My First Template**.
## Schermate di errore [#schermate-di-errore]
| Titolo | Quando |
| --------------------------------- | ---------------------------- |
| **Could not reach the MailG API** | Errore API / rete |
| **Could not read your sheet** | Errore di lettura del foglio |
## Avanti [#avanti]
# Installazione (/it/getting-started/installation)
Due passaggi: installa il componente aggiuntivo, poi avvialo da Sheets.
## Installa MailG [#installa-mailg]
1. Apri la [pagina MailG su Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Clicca **Install**.
3. Scegli l’account Google che deve possedere l’installazione.
4. Rivedi le autorizzazioni e clicca **Allow**.
L’installazione di solito termina in meno di 15 secondi. Dovresti vedere una conferma che il componente aggiuntivo è stato installato.
Se la pagina Marketplace non è ancora attiva nella tua regione, usa il pulsante di installazione su [www.mailg.io](https://www.mailg.io) o contatta [contact@mailg.io](mailto:contact@mailg.io).
## Avvia MailG in Google Sheets [#avvia-mailg-in-google-sheets]
1. Apri [Google Sheets](https://sheets.google.com) (aggiorna se Sheets era già aperto).
2. Attendi qualche secondo per il caricamento di Extensions (spesso \~10–15 secondi).
3. Vai su **Extensions → MailG for Gmail → 🚀 Start**.
In seguito puoi eseguire **Extensions → MailG for Gmail → 🔄 Refresh Tracking** per sincronizzare gli stati di apertura senza aprire l’intera finestra di dialogo.
## Problemi di installazione [#problemi-di-installazione]
Si tratta di comportamenti comuni di Google Workspace, non di bug di MailG:
### Non compare mai il popup «installed successfully» [#non-compare-mai-il-popup-installed-successfully]
Succede spesso quando sono connessi più account Google e l’installazione non ha usato l’account previsto.
**Soluzione alternativa:** apri una finestra privata/incognito, accedi solo con l’account di destinazione, poi reinstalla dal Marketplace.
### MailG non compare sotto Extensions [#mailg-non-compare-sotto-extensions]
1. Aggiorna il foglio di calcolo.
2. Attendi circa 10–15 secondi per il caricamento dei componenti aggiuntivi.
3. Conferma di essere con lo stesso account Google che ha installato MailG.
4. Prova un altro foglio di calcolo o svuota la cache del browser se continua a mancare.
## Distribuzioni self-hosted / personalizzate [#distribuzioni-self-hosted--personalizzate]
Le installazioni Marketplace sono preconfigurate. Se distribuisci MailG autonomamente, imposta le proprietà dello script Apps Script:
| Proprietà | Valore |
| ------------- | -------------------------------------- |
| `APP_URL` | URL HTTPS pubblico della tua MailG API |
| `APP_API_KEY` | Stessa chiave del server API |
Il componente aggiuntivo non può raggiungere `localhost` dai server Google — usa un tunnel (Cloudflare Tunnel, ngrok, ecc.) per i test locali.
## Avanti [#avanti]
Continua con il [tutorial mail merge](/getting-started/mail-merge-tutorial).
# Tutorial mail merge (/it/getting-started/mail-merge-tutorial)
Questa guida corrisponde alla finestra di avvio **MailG for Gmail**.
## 1. Apri MailG [#1-apri-mailg]
**Extensions → MailG for Gmail → 🚀 Start**.
Se vedi **No email address found in your sheet**, aggiungi email reali o clicca **Fill with mock data** (crea righe di esempio e spesso **My First Template**). Vedi [Tour della finestra di avvio](/getting-started/start-dialog).
## 2. Crea o seleziona un template [#2-crea-o-seleziona-un-template]
1. Clicca **New Template** (o scegline uno esistente sotto **Template**).
2. Imposta **Template Name** e **Email Subject** (l’oggetto **non** viene sostituito con merge oggi).
3. Scrivi il corpo e inserisci i [merge tag](/features/merge-tags) tramite **Merge Tag**.
4. **Save Template**.
Esempio di corpo:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Configura la campagna [#3-configura-la-campagna]
Nella sidebar:
1. Scegli **Recipient column** (le celle devono contenere un’unica email valida affinché l’interfaccia le conti).
2. Apri **More options** per **CC**, **BCC**, **Sender name**, **Reply to address**.
3. Lascia **Track emails** attivo (predefinito) se vuoi lo stato di apertura nel foglio.
4. Su un piano a pagamento, attiva **Remove branding**.
**Attachments** compare sotto **More options**, ma i file non vengono ancora allegati all’invio. Usa invece un link a Drive o a un URL nel corpo.
## 4. Anteprima e test [#4-anteprima-e-test]
1. Usa le frecce precedente/successivo per scorrere le righe.
2. Conferma **To:** e il corpo con merge (l’oggetto mostra l’oggetto grezzo del template).
3. Menu di invio → **Send me a test email**.
4. Controlla la tua casella di posta.
Dettagli: [Anteprima e test](/features/preview-and-test).
## 5. Invia o programma [#5-invia-o-programma]
* Pulsante principale: **Send N email(s)** quando i destinatari sono contati.
* Oppure menu di invio → **Schedule send** → scegli data/ora → **Schedule Send**.
Overlay di attività: `Starting your campaign…` / toast di conferma della programmazione.
MailG aggiunge una colonna campagna come `🚀 My Template (yyyy/MM/dd)` o `🗓️ …` se programmata.
Stati delle righe:
| Stato | Significato |
| ------------- | -------------------------- |
| 🗓️ Scheduled | In attesa di avvio |
| ⏳ Sending… | In elaborazione |
| ✉️ Sent | Consegnato a Gmail |
| ⚠️ Failed | Errore |
| 👀 Opened | Pixel di apertura caricato |
## Errori comuni [#errori-comuni]
* Tag nell’oggetto che si aspettano personalizzazione — per ora solo il corpo
* Celle destinatario con più indirizzi separati da virgola — l’interfaccia valida **un’** email per cella per il conteggio
* Account Google sbagliato rispetto all’account di installazione
* Quota giornaliera esaurita — controlla **Daily quota** nella sidebar
## Suggerimenti [#suggerimenti]
* Usa la checklist **Help** nel footer la prima volta
* Inizia con 2–3 righe reali dopo i mock data
* Dopo le aperture: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alert `Tracking info synced` (o `No active campaigns`)
## Avanti [#avanti]
# Cos’è MailG? (/it/getting-started/what-is-mailg)
MailG trasforma un Google Sheet in una campagna di mail merge. Ogni riga è un destinatario; le intestazioni delle colonne diventano merge tag (doppie parentesi graffe attorno al nome dell’intestazione) nel **corpo dell’email**.
## Cosa puoi fare [#cosa-puoi-fare]
* Creare template salvati nel cloud (**Template Name**, **Email Subject**, corpo ricco)
* Personalizzare il **corpo** con merge tag dalle intestazioni del foglio
* Visualizzare l’anteprima delle righe e **Send me a test email**
* Mappare **CC** / **BCC**, **Sender name**, **Reply to address**
* **Schedule send** o inviare immediatamente
* **Track emails** con chip di stato di apertura nel foglio
* Controllare **Send pacing** sui piani a pagamento
* **Remove branding** sui piani a pagamento
* Monitorare **Daily quota** (e, opzionalmente, richiedere un bonus gratuito per recensione)
## Come si integra [#come-si-integra]
1. **Componente aggiuntivo Google Sheets** — finestra di dialogo sotto **MailG for Gmail**
2. **MailG API** — template, metadati delle campagne, tracking delle aperture, diritti d’uso
3. **Il tuo Gmail** — messaggi inviati con `GmailApp` dall’account autorizzato
## Prossimi passi [#prossimi-passi]
# Contacte-nos (/pt/contact-us)
## Faturação e subscrições [#faturação-e-subscrições]
Pode gerir a maior parte das alterações de subscrição a partir do portal Stripe ligado através dos [preços](https://app.mailg.io/pricing?lang=pt). Para reembolsos ou problemas de pagamento, envie-nos um email.
## Tudo o resto [#tudo-o-resto]
Envie um email para **[contact@mailg.io](mailto:contact@mailg.io)**.
Normalmente respondemos no prazo de um dia útil.
## Ligações úteis [#ligações-úteis]
* [Website](https://www.mailg.io)
* [Preços](https://app.mailg.io/pricing?lang=pt)
* [Privacidade](https://www.mailg.io/pt/privacy)
* [Termos](https://www.mailg.io/pt/terms)
* [Início da documentação](/)
# Documentação MailG (/pt)
O MailG é um add-on do Google Sheets para mail merge com o Gmail. Abra **Extensions → MailG for Gmail → 🚀 Start**, crie um template, pré-visualize linhas e envie ou agende a partir da sua conta Gmail.
## Comece aqui [#comece-aqui]
## Tópicos populares [#tópicos-populares]
## Ligações úteis [#ligações-úteis]
* Site: [www.mailg.io](https://www.mailg.io)
* Documentação: [docs.mailg.io/pt](https://docs.mailg.io/pt)
* Preços: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=pt)
* Contacto: [contact@mailg.io](mailto:contact@mailg.io)
## Para assistentes de IA / LLMs [#para-assistentes-de-ia--llms]
Prefira estes endpoints legíveis por máquinas em vez de fazer scraping do HTML:
* [Agents hub](https://www.mailg.io/pt/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/pt/help/faq)
## Instalação e abertura [#instalação-e-abertura]
**Como abro o MailG?**\
**Extensions → MailG for Gmail → 🚀 Start**. Consulte [Instalação](/getting-started/installation).
**No email address found in your sheet**\
Adicione emails a uma coluna ou clique em **Fill with mock data**. Consulte o [Tour do diálogo Start](/getting-started/start-dialog).
**Could not reach the MailG API**\
Verifique rede / URL da API (self-hosted: `APP_URL` + `APP_API_KEY`). Reabra o diálogo após corrigir.
## Envio [#envio]
**Os emails não estão a ser enviados**\
Verifique **Daily quota**, permissões Gmail e que as células da **Recipient column** são emails únicos válidos. Falhas mostram **⚠️ Failed**.
**As merge tags no assunto funcionam?**\
Ainda não. Apenas o **corpo** é substituído. Mantenha um assunto fixo ou coloque a personalização no corpo. Consulte [Merge tags](/features/merge-tags).
**Posso anexar ficheiros?**\
O seletor **Attachments** existe em **More options**, mas os ficheiros ainda não são anexados no envio. Use links.
**Como paro uma campanha?**\
[Parar uma campanha](/features/stopping-a-campaign) — limpe estados enviáveis nas linhas restantes.
**Porque estou limitado no Professional?**\
O MailG pode permitir até 1.500/dia, mas `@gmail.com` gratuito é frequentemente limitado perto de 500 pela Google.
## Tracking [#tracking]
**A folha ainda diz Sent após uma abertura**\
**🔄 Refresh Tracking** → espere `Tracking info synced`. Alguns clientes nunca carregam imagens.
**Cliques?**\
Não são rastreados. **Track emails** = apenas aberturas.
## Quota e faturação [#quota-e-faturação]
Consulte [Daily quota e avaliações](/help/daily-quota-and-reviews) e [Conta e faturação](/help/account-and-billing).
**O Schedule send é pago?**\
Não. O plano pago desbloqueia quotas mais altas, modos de pacing e **Remove branding**.
## Resolução de problemas [#resolução-de-problemas]
Para correções passo a passo (erros API, folha vazia, botão de envio desativado, linhas falhadas, tracking, quota, agendamento que não difere), consulte [Resolução de problemas](/help/troubleshooting).
Toasts comuns que pode ver:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Ainda com dificuldades? [#ainda-com-dificuldades]
[Resolução de problemas](/help/troubleshooting) · Documentação [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Resolução de problemas (/pt/help/troubleshooting)
Correções rápidas para as mensagens e estados que vê no add-on.
## O diálogo não carrega [#o-diálogo-não-carrega]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
O diálogo start não conseguiu chamar o backend MailG.
* Confirme que está online
* Instalações Marketplace: aguarde um momento e reabra **🚀 Start**
* Self-hosted: verifique propriedades Apps Script `APP_URL` (HTTPS pública) e `APP_API_KEY`
* O add-on não pode usar `localhost` — use um túnel para testes API locais
### Could not read your sheet [#could-not-read-your-sheet]
O MailG falhou ao ler a folha de cálculo ativa.
* Certifique-se de que um separador da folha está aberto (não apenas o editor Apps Script)
* Recarregue a folha de cálculo e reabra o diálogo
* Confirme que tem acesso de edição ao ficheiro
### Loading… nunca termina [#loading-nunca-termina]
Feche o diálogo, atualize o Sheets, aguarde \~15 segundos para Extensions e **🚀 Start** novamente.
## Folha vazia [#folha-vazia]
**No email address found in your sheet**
O MailG precisa de pelo menos uma coluna com endereços de email válidos.
* Adicione emails sob um cabeçalho ou clique em **Fill with mock data**
* Dados mock criam `Email`, `First Name`, `Last Name`, `Company` e frequentemente **My First Template**
Consulte o [Tour do diálogo Start](/getting-started/start-dialog).
## Modelos [#modelos]
* Criar: `Creating Template...` → `Template created successfully!` ou `Failed to create template! Try again later.`
* Atualizar: `Updating template...`
* Falhas ao eliminar: `Failed to delete template. Try again later`
Consulte [Templates](/features/templates).
## Problemas de envio [#problemas-de-envio]
### Botão de envio desativado / Send emails sem contagem [#botão-de-envio-desativado--send-emails-sem-contagem]
* Selecione um **Template**
* Selecione uma **Recipient column** com emails **únicos** válidos por célula
* Toasts de bloqueio que pode ver: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### A campanha falha ao iniciar [#a-campanha-falha-ao-iniciar]
Toast: `Failed to create campaign. Please try again.`
* Tente novamente uma vez
* Verifique se **Daily quota** não é 0
* Confirme conectividade API (consulte acima)
### Linhas mostram ⚠️ Failed [#linhas-mostram-️-failed]
Essa linha teve um erro de envio (endereço inválido, rejeição Gmail, quota transitória, etc.). Corrija os dados e inicie uma nova campanha para as linhas restantes, ou consulte [Parar uma campanha](/features/stopping-a-campaign).
### Email de teste falha [#email-de-teste-falha]
* `Configure your preview first` — escolha template + destinatário para a pré-visualização ter To
* `Failed to send test email. Please check your email settings.` — reautorize o Gmail se necessário e tente novamente
## Tracking [#tracking]
* Aberturas exigem imagens remotas carregadas pelo destinatário
* Execute **🔄 Refresh Tracking** — espere `Tracking info synced` ou `No active campaigns`
* Estado **👀 Opened** só aparece quando o pixel carrega
Consulte [Email tracking](/features/email-tracking).
## Quota e branding [#quota-e-branding]
* **N left** na barra lateral é `min(MailG remaining, Gmail remaining)`
* `@gmail.com` gratuito é frequentemente limitado perto de 500/dia pela Google mesmo no Professional
* Marca de água ainda presente após pagamento → email do checkout deve coincidir com conta Sheets; reabra o diálogo
Consulte [Daily quota e avaliações](/help/daily-quota-and-reviews) e [Remove branding](/features/remove-branding).
## O agendamento não diferiu [#o-agendamento-não-diferiu]
Horas a menos de cerca de **15 segundos** à frente são tratadas como envio **imediato** (coluna 🚀), não como agendamento diferido 🗓️. Escolha uma hora mais distante no futuro.
## Ainda com dificuldades? [#ainda-com-dificuldades]
FAQ completa: [FAQ](/help/faq) · Email [contact@mailg.io](mailto:contact@mailg.io) · Site [app.mailg.io/help](https://www.mailg.io/pt/help)
# Quota diária e avaliações (/pt/help/daily-quota-and-reviews)
A barra lateral raiz mostra a sua capacidade de envio quando os dados da conta estão carregados.
## Bloco Daily quota [#bloco-daily-quota]
UI exata:
* Etiqueta: **Daily quota**
* Restante: **N left**
* Linha do plano: **Your plan sends up to TOTAL/day**
**Remaining** é o mínimo de:
1. Restante do plano MailG para o dia
2. Quota de envio Gmail restante para a conta
Por isso pode ser limitado pelo Gmail mesmo quando o MailG ainda mostra margem no papel. Consulte também [Conta e faturação](/help/account-and-billing).
## CTAs do plano gratuito [#ctas-do-plano-gratuito]
Quando não está subscrito, a barra lateral pode mostrar:
* **Leave a 5★ review for +N/day free** (bónus predefinição **+50/day** quando a API não especifica outro valor)
* **Or upgrade your plan**
Clicar no CTA de avaliação abre **Free Quota upgrade**:
* Título: **Free Quota upgrade**
* Corpo: deixe uma avaliação 5 estrelas para obter um upgrade gratuito de quota de **+N emails/day**
* Botões: **Not now** | **Leave a 5★ review**
Se o URL de avaliação não estiver configurado, **Leave a 5★ review** permanece desativado — use **Upgrade to Pro** / preços em alternativa.
## Atualizar para Pro [#atualizar-para-pro]
Botão no rodapé (contas gratuitas): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
Isto corresponde ao que os planos pagos desbloqueiam no produto hoje.
## Relacionado [#relacionado]
* [Remove branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Conta e faturação (/pt/help/account-and-billing)
A faturação MailG está ligada ao **email da sua conta Google** no Sheets. Faça sempre checkout com esse mesmo endereço para as quotas desbloquearem no add-on.
## Planos e quotas diárias [#planos-e-quotas-diárias]
| Plano | Quota diária | Notas |
| ------------ | ------------ | ------------------------------------------------ |
| Free | 50 | Merge básico, tracking de aberturas, agendamento |
| Personal | 250 | Plano popular para listas em crescimento |
| Professional | 1.500 | Quota recorrente mais elevada |
| Lifetime | 1.500 | Compra única |
Preços e intervalos estão listados em [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=pt) (EUR e USD).
Os direitos pagos também desbloqueiam:
* [Send pacing](/features/send-pacing) não predefinido (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
O seu volume de envio efetivo é `min(MailG daily quota, Gmail remaining quota)`.
## Como fazer upgrade [#como-fazer-upgrade]
1. Abra [preços](https://app.mailg.io/pricing?lang=pt) (também ligado a partir do add-on via **Upgrade to Pro**).
2. Escolha um plano e complete o Stripe Checkout com o email Google Sheets.
3. Reabra o MailG no Sheets para a atualização da conta recolher o novo limite.
## Cancelar ou atualizar uma subscrição [#cancelar-ou-atualizar-uma-subscrição]
Pode cancelar ou alterar a subscrição a partir do portal de cliente Stripe ligado ao fluxo de subscrição / preços.
* Se cancelar a meio do ciclo, funcionalidades Premium permanecem ativas até ao fim do período pago
* Não será cobrado novamente após o cancelamento entrar em vigor
## Reembolsos [#reembolsos]
Se cancelar uma subscrição Premium no prazo de **30 dias** após a compra, pode solicitar reembolso total enviando email para [contact@mailg.io](mailto:contact@mailg.io).
## Faturas [#faturas]
O Stripe envia recibos por email para pagamentos bem-sucedidos. Também pode descarregar faturas a partir do portal de cliente Stripe usado para gestão de subscrição.
## Excertos FAQ [#excertos-faq]
**O MailG está incluído no Google Workspace?**\
Não. O MailG é independente da Google. Uma subscrição Workspace não inclui MailG.
**Que métodos de pagamento são aceites?**\
Cartões principais, Google Pay e Apple Pay via Stripe. PayPal não é suportado.
**Paguei mas ainda vejo o limite gratuito / marca de água**\
Quase sempre é incompatibilidade de email. Confirme email checkout = email conta Sheets e reabra o add-on. Se persistir, contacte o suporte com ambos os emails.
**Porque o Gmail gratuito está limitado a cerca de 500 emails por dia?**\
O MailG Professional permite até 1.500 emails por dia, mas a Google limita contas `@gmail.com` gratuitas a cerca de 500 envios por dia. Contas Google Workspace podem ir mais alto. Isto é um limite do fornecedor Gmail, não do MailG.
# Agendamento de campanhas (/pt/features/campaign-scheduling)
Use **Schedule send** quando quiser que o MailG comece mais tarde. Disponível nos planos gratuitos e pagos.
## Como agendar [#como-agendar]
1. Configure template e destinatários para o botão de envio estar ativo.
2. Abra o menu de envio (chevron) → **Schedule send**.
3. Título do diálogo: **Schedule send**
4. Descrição: `Pick date & time to schedule sending`
5. Linha de resumo: agendar N emails para envio a partir da data/hora escolhida
6. Use o seletor de data mais **Hour** / **Minute** (placeholders `Hour`, `Min`).
7. Confirme com **Schedule Send** (ou **Cancel**).
A sugestão predefinida é cerca de **60 minutos** à frente, arredondada ao passo seguinte de **15 minutos**.
## Imediato vs agendado [#imediato-vs-agendado]
Horas a menos de cerca de **15 segundos** à frente são tratadas como envio **imediato** (cabeçalho de coluna 🚀), não como agendamento diferido 🗓️. Escolha uma hora mais distante no futuro se precisar de envio diferido.
Toasts de validação: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Toast de sucesso: campanha agendada; N emails começarão na hora escolhida.
## Coluna da folha [#coluna-da-folha]
Campanhas agendadas criam um cabeçalho de coluna como:
```text
🗓️ Template name (yyyy/MM/dd)
```
Envios imediatos usam 🚀 em vez de 🗓️.
As linhas começam como **🗓️ Scheduled** e passam para **⏳ Sending…** quando a fila executa.
## Depois de agendar [#depois-de-agendar]
* Mantenha a folha de cálculo acessível à conta Google proprietária do add-on
* Tracking e pacing aplicam-se quando o envio começa
* Sem UI **Manage Schedule** — consulte [Parar uma campanha](/features/stopping-a-campaign)
## Relacionado [#relacionado]
* [Pré-visualização e teste](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Vários destinatários (/pt/features/multiple-recipients)
Pode adicionar destinatários em cópia carbono por linha com colunas dedicadas na folha.
## Coluna de destinatários (Para) [#coluna-de-destinatários-para]
Selecione **Recipient column** na barra lateral.
Para a contagem do botão de envio e validação da coluna, o MailG trata uma célula como válida quando é um **único** endereço de email. Prefira um endereço To principal por linha.
## Colunas CC e BCC [#colunas-cc-e-bcc]
1. Adicione colunas na folha (por exemplo `CC` e `BCC`).
2. Coloque um email (ou lista aceite pelo Gmail) na célula.
3. Abra **More options** e mapeie **CC** / **BCC**.
4. No envio, esses valores são passados ao Gmail.
O painel de pré-visualização mostra apenas **From**, **To**, **Subject** e corpo. **Não** exibe linhas CC/BCC mesmo quando mapeadas. Confirme com **Send me a test email** se precisar de verificar a entrega CC/BCC.
## Quotas: MailG vs Gmail [#quotas-mailg-vs-gmail]
* **Daily quota MailG** conta **linhas de campanha** processadas.
* **Limites de envio Gmail** contam **destinatários** (endereços To + CC + BCC que o Gmail aceita nesse envio).
Pode atingir o limite do Gmail enquanto a quota MailG ainda tem margem.
## Dicas [#dicas]
* Prefira **BCC** quando os destinatários não devem ver uns aos outros
* Deixe CC/BCC sem mapear quando não usados
* Valide endereços antes de um envio grande
# Attachments (/pt/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Visão geral das funcionalidades (/pt/features/features-overview)
O que o add-on suporta hoje:
| Funcionalidade | Documentação |
| --------------------------------------------- | --------------------------------------------------------- |
| Diálogo start / folha vazia / dados mock | [Tour do diálogo Start](/getting-started/start-dialog) |
| Templates (criar / gerir / editar / eliminar) | [Templates](/features/templates) |
| Merge tags no **corpo** | [Merge tags](/features/merge-tags) |
| Barra de ferramentas rich text | [Emails rich text](/features/rich-text-emails) |
| Links (não incorporação de imagens) | [Imagens](/features/images) |
| Pré-visualização + email de teste | [Pré-visualização e teste](/features/preview-and-test) |
| Schedule send | [Agendamento de campanhas](/features/campaign-scheduling) |
| Send pacing (pago) | [Send pacing](/features/send-pacing) |
| Colunas CC / BCC | [Vários destinatários](/features/multiple-recipients) |
| Track emails | [Email tracking](/features/email-tracking) |
| Sender name e reply-to | [Remetente personalizado](/features/customized-sender) |
| Remove branding (pago) | [Remove branding](/features/remove-branding) |
| Parar linhas restantes | [Parar uma campanha](/features/stopping-a-campaign) |
| Daily quota + bónus por avaliação | [Daily quota e avaliações](/help/daily-quota-and-reviews) |
## Pago vs gratuito [#pago-vs-gratuito]
O plano pago desbloqueia:
* [Send pacing](/features/send-pacing) não predefinido
* [Remove branding](/features/remove-branding)
* [Quotas diárias](/help/account-and-billing) mais elevadas
**Schedule send**, **Track emails** e ferramentas de template funcionam sem upgrade pago.
## Lacunas conhecidas (transparência) [#lacunas-conhecidas-transparência]
| Tópico | Estado no produto |
| --------------------------------- | ----------------------------------------------------- |
| Merge tags no assunto | Não aplicadas no envio — apenas o corpo |
| Coluna Attachments | Apenas UI — não anexada no envio |
| Incorporação de imagens | Sem controlo no editor — use links |
| Linhas CC/BCC na pré-visualização | Não mostradas na UI de pré-visualização |
| Manage Schedule / Pause | Ainda não disponível — solução alternativa por estado |
## Em breve [#em-breve]
Links de cancelamento de subscrição, tracking de cliques, lugares partilhados em equipa e uma UI dedicada de gestão de campanhas quando forem lançados.
# Monitorização de e-mails (/pt/features/email-tracking)
O MailG pode registar aberturas com um pixel invisível minúsculo.
## Ativar tracking [#ativar-tracking]
Na barra lateral, deixe **Track emails** ativado (predefinição ativada para novos jobs).
Tooltip: `Track emails opened with a tiny pixel`
O ícone de ajuda abre **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Botão: **Got it**
## Estados na folha [#estados-na-folha]
| Estado | Significado |
| ------------- | --------------------------------- |
| 🗓️ Scheduled | À espera do início agendado |
| ⏳ Sending… | A ser processado |
| ✉️ Sent | Entregue ao Gmail para essa linha |
| ⚠️ Failed | Erro de envio para essa linha |
| 👀 Opened | Pixel de abertura foi carregado |
Cabeçalhos de coluna de campanha parecem-se com `🚀 Template name (yyyy/MM/dd)` ou `🗓️ …` quando agendado.
## Atualizar tracking [#atualizar-tracking]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Alertas Apps Script:
* `Tracking info synced`
* `No active campaigns`
## Limitações [#limitações]
* O cliente tem de carregar imagens remotas
* Proxies de privacidade podem ocultar aberturas
* Apenas aberturas — não cliques em links
## Relacionado [#relacionado]
* [Agendamento de campanhas](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Etiquetas de fusão (/pt/features/merge-tags)
As merge tags permitem que cada destinatário receba um **corpo** personalizado. Uma tag é o **cabeçalho exato da coluna** envolvido em chavetas duplas.
## Sintaxe [#sintaxe]
Se a sua folha tiver uma coluna chamada `First Name`, use:
```text
{{First Name}}
```
Exemplo de corpo:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Onde as merge tags funcionam hoje [#onde-as-merge-tags-funcionam-hoje]
| Campo | Substituído no envio? |
| --------------------------- | ------------------------------------------------------- |
| Corpo do email | **Sim** — variáveis injetadas por linha |
| Assunto do email | **Não** — o assunto é enviado como guardado no template |
| Corpo na pré-visualização | **Sim** — para a linha ativa |
| Assunto na pré-visualização | **Não** — mostra o assunto bruto do template |
Coloque a personalização no corpo até o merge no assunto estar disponível.
## Inserir tags [#inserir-tags]
Na barra de ferramentas do editor, abra **Merge Tag**. Lista cabeçalhos da folha ativa. Estado vazio: `No sheet columns found`.
O texto inserido usa chavetas duplas em volta do nome da coluna.
## Regras práticas [#regras-práticas]
* Os cabeçalhos são sensíveis a maiúsculas/minúsculas (`Name` ≠ `name`)
* Células vazias inserem-se como strings vazias
* Pode reutilizar a mesma tag várias vezes no corpo
* Recipient / CC / BCC são escolhidos em **More options**, não via merge tags
## Seguinte [#seguinte]
Consulte [Emails rich text](/features/rich-text-emails) e [Pré-visualização e teste](/features/preview-and-test).
# E-mails rich text (/pt/features/rich-text-emails)
Os templates MailG usam um editor rich text TipTap. O HTML que produz é o que o Gmail entrega.
Placeholder do corpo: `Write your email…`
## Inventário da barra de ferramentas (UI exata) [#inventário-da-barra-de-ferramentas-ui-exata]
| Grupo | Controlos |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Família de fonte | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Tamanho da fonte | **10pt** … **24pt** (predefinições na barra de ferramentas) |
| Marcas | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Cor | Amostras predefinidas + seletor de cor nativo + **Reset** |
| Alinhamento | **Align left**, **Align center**, **Align right**, **Justify** |
| Listas | **Bullet list**, **Numbered list** |
| Link | **Insert link** — placeholder do campo URL `https://example.com`, depois **Apply** (e desligar link) |
| Histórico | **Undo**, **Redo** |
## Não disponível no editor [#não-disponível-no-editor]
Estas funcionalidades TipTap estão desativadas / ausentes:
* Títulos, código, bloco de código, blockquote, linha horizontal
* Inserção de imagem / seletor de media Drive — consulte [Imagens](/features/images)
## Hiperligações [#hiperligações]
Use **Insert link** para o URL e o texto visível. Prefira texto de link claro em vez de URLs brutas.
## Dicas [#dicas]
* Use **Merge Tag** em vez de escrever chavetas manualmente
* Pré-visualize várias linhas antes de enviar — consulte [Pré-visualização e teste](/features/preview-and-test)
* Evite colar markup enorme do Word/Docs; reaplique formatação no MailG para HTML mais limpo
# Remover a marca MailG (/pt/features/remove-branding)
Campanhas gratuitas podem incluir uma pequena marca de água MailG no rodapé do email. Subscritores pagos podem desativá-la.
## Como remover branding [#como-remover-branding]
1. Confirme que tem um plano pago ativo (Personal, Professional ou Lifetime).
2. Abra a barra lateral da campanha.
3. Ative **Remove branding**.
4. Pré-visualize uma linha para confirmar que a marca de água desapareceu e envie.
Se o branding ainda aparecer depois de pagar:
* Certifique-se de que o checkout usou o **mesmo email** que a sua conta Google Sheets
* Reabra o add-on para atualizar os direitos a partir da API
* Contacte [contact@mailg.io](mailto:contact@mailg.io) com o email da sua conta Google
Consulte [Conta e faturação](/help/account-and-billing).
# Imagens (/pt/features/images)
O editor MailG **não tem botão de inserção de imagem** nem seletor de media do Google Drive. A extensão Image do TipTap não está ativada.
## O que pode fazer hoje [#o-que-pode-fazer-hoje]
Use **Insert link** na barra de ferramentas:
1. Aloje a imagem (ou ficheiro) num URL público, ou partilhe um link do Drive.
2. Selecione texto (ou coloque o cursor) → **Insert link**.
3. Cole o URL (placeholder `https://example.com`) → **Apply**.
Os destinatários abrem o link para ver a imagem ou ficheiro. O editor não incorpora tags `![]()
` por si.
## Dicas [#dicas]
* Prefira ficheiros pequenos e texto de link claro («Ver captura de ecrã»)
* Links que exigem login falham para os destinatários
* Confirme com **Send me a test email**
## Em breve [#em-breve]
Uma incorporação de imagem de primeira classe / seletor Drive pode ser lançada mais tarde. Até lá, hiperligações são o caminho suportado.
# Modelos (/pt/features/templates)
Os templates guardam o assunto e o corpo rich text que reutiliza entre campanhas. São guardados na API MailG para a sua conta Google.
## Criar um template [#criar-um-template]
1. No ecrã raiz, clique em **New Template**.
2. Preencha:
* **Template Name**
* **Email Subject**
* Corpo (editor rich text — consulte [Emails rich text](/features/rich-text-emails))
3. Clique em **Save Template** (mostra **Saving...** enquanto processa).
Toasts:
* A carregar: `Creating Template...`
* Sucesso: `Template created successfully!`
* Erro: `Failed to create template! Try again later.`
Template demo de **Fill with mock data**: nome **My First Template**, assunto `I found a mail merge tool for Gmail`.
## Gerir templates [#gerir-templates]
Abra o ícone de template junto à seleção de template (tooltip **Manage templates**).
Colunas da tabela:
| Coluna | Conteúdo |
| ----------------- | ---------------- |
| **Name** | Nome do template |
| **Email Subject** | Linha de assunto |
| **Created At** | Data de criação |
| **Actions** | Menu da linha |
Menu da linha: **Edit** | **Delete**
Rodapé: **Back**
Toasts de eliminação: deleting template NAME → template NAME deleted successfully (ou mensagem de falha).
## Editar um template [#editar-um-template]
Abra **Edit** em gerir, ou clique em **Edit template** na barra de ferramentas de pré-visualização.
Os mesmos campos que na criação. **Save Template** atualiza o template.
O fluxo de atualização mostra um toast de carregamento (`Updating template...`). Permaneça no formulário até terminar e use **Cancel** ou **Back** se não for redirecionado automaticamente.
## Assunto vs corpo [#assunto-vs-corpo]
* O **corpo** suporta [merge tags](/features/merge-tags) — são injetadas por linha no envio.
* **Email Subject** é enviado como guardado atualmente (merge tags no assunto **não** são substituídas ainda). Coloque a personalização no corpo ou use um assunto fixo.
## Relacionado [#relacionado]
* [Pré-visualização e teste](/features/preview-and-test)
* [Tour do diálogo Start](/getting-started/start-dialog)
# Pré-visualização e teste (/pt/features/preview-and-test)
O painel de pré-visualização (lado direito do diálogo raiz) mostra como uma mensagem fica para a linha ativa da folha.
## O que a pré-visualização mostra [#o-que-a-pré-visualização-mostra]
| Campo | Conteúdo |
| ------------ | -------------------------------------------------------------------------------- |
| **From:** | Email da conta Google com sessão iniciada |
| **To:** | Valor da **Recipient column** para a linha ativa, ou `Select a recipient column` |
| **Subject:** | Assunto do template como guardado (sem substituição por merge) |
| Corpo | Corpo do template com merge tags aplicadas para essa linha |
Se **Remove branding** estiver desativado, a pré-visualização inclui o rodapé de marca de água MailG (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## O que não é mostrado [#o-que-não-é-mostrado]
* As linhas **CC** / **BCC** não são renderizadas na UI de pré-visualização (mesmo quando mapeadas em **More options**). São aplicadas no envio.
* Valores da coluna Attachments não são mostrados na pré-visualização.
## Navegar entre linhas [#navegar-entre-linhas]
Barra de ferramentas de pré-visualização:
* **Edit template** — abre o ecrã de atualização de template
* **Previous recipient** / **Next recipient** — mover entre linhas de dados (tooltips podem incluir o número da linha da folha; o cabeçalho é a linha 1, pelo que o primeiro contacto é a linha 2)
## Enviar-me um e-mail de teste [#enviar-me-um-e-mail-de-teste]
1. Configure template + Recipient column para a pré-visualização ser válida.
2. Abra o menu de envio (chevron) → **Send me a test email**.
3. Overlay de ocupado: `Sending test email…`
4. Toast de sucesso: `Test email sent successfully. Check your inbox.`
5. Toast de falha: `Failed to send test email. Please check your email settings.`
6. Bloqueio se a pré-visualização estiver incompleta: `Configure your preview first`
O teste vai para a caixa de entrada da **sua** conta Google, usando o corpo com merge da linha de pré-visualização ativa.
## Dicas [#dicas]
* Percorra várias linhas com as setas antes de um envio completo
* Confirme branding / sem branding na pré-visualização
* Teste sempre antes de **Schedule send** ou um **Send N email(s)** grande
## Relacionado [#relacionado]
* [Merge tags](/features/merge-tags)
* [Tutorial de mail merge](/getting-started/mail-merge-tutorial)
# Ritmo de envio (/pt/features/send-pacing)
O Send pacing adiciona atraso entre mensagens para que uma campanha grande não saia da sua conta num único burst.
**Steady pace** e **Jittered gaps** requerem uma subscrição MailG paga ativa. Contas gratuitas usam apenas **Burst send**.
## Onde configurar [#onde-configurar]
Abra a engrenagem no rodapé (tooltip **Send pacing**). Título do ecrã: **Send pacing**.
Em **Dispatch mode**, escolha como os emails são espaçados. **Gap between emails** é definido em **segundos** (0–60). Contas gratuitas veem **Pro features** e o texto bloqueado: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Predefinição para novos jobs: **Burst send**, intervalo **10s** (intervalo ignorado até sair do burst).
## Modos [#modos]
| Modo (etiqueta UI) | Comportamento |
| ----------------------------- | ----------------------------------------------------------- |
| **Burst send** (predefinição) | Enviar o mais rápido que as quotas permitirem |
| **Steady pace** | Esperar um intervalo fixo entre cada email |
| **Jittered gaps** | Esperar um intervalo aleatório entre 0 e o máximo escolhido |
## Porquê usar pacing [#porquê-usar-pacing]
* Reduzir a probabilidade de parecer um burst súbito para os fornecedores de caixa de correio
* Distribuir uma lista longa por uma janela de envio mais calma
* Manter-se dentro das zonas de conforto do Gmail para o seu tipo de conta
## Notas [#notas]
* O pacing é uma definição de campanha guardada com o job — novos envios usam a configuração atual
* Um intervalo longo numa lista grande aumenta significativamente a duração total da campanha
* A sua velocidade efetiva continua limitada pela Daily quota MailG **e** pela quota de envio restante do Gmail
* Ferramentas concorrentes por vezes expressam atraso em minutos — o MailG usa **segundos**
## Relacionado [#relacionado]
* [Parar uma campanha](/features/stopping-a-campaign) se um intervalo foi definido demasiado alto a meio da execução
* [Conta e faturação](/help/account-and-billing)
# Parar uma campanha (/pt/features/stopping-a-campaign)
O MailG ainda não disponibiliza um ecrã dedicado **Manage Schedule**, **Abort** ou **Pause** como alguns concorrentes. Ainda assim pode impedir que **linhas restantes** sejam enviadas.
## Como o envio decide o que processar [#como-o-envio-decide-o-que-processar]
O ciclo de envio só processa linhas cujo estado na coluna de campanha ainda é enviável:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
Linhas já marcadas como **✉️ Sent**, **⚠️ Failed** ou **👀 Opened** são ignoradas.
## Parar linhas restantes (solução alternativa honesta) [#parar-linhas-restantes-solução-alternativa-honesta]
Aja rapidamente numa campanha grande:
1. Abra a folha de cálculo.
2. Na coluna de estado da campanha, limpe ou altere o estado nas linhas que **não** devem enviar (por exemplo apague o valor da célula ou defina uma etiqueta não enviável como `Stopped`).
3. Deixe em paz as linhas já **✉️ Sent** — essas mensagens já saíram.
As linhas que limpar/alterar deixam de corresponder aos estados enviáveis, pelo que a fila as ignora na passagem seguinte.
Mensagens Gmail que já saíram da conta não podem ser desfeitas pelo MailG. Parar só protege linhas que ainda não foram processadas.
## Campanhas agendadas que ainda não começaram [#campanhas-agendadas-que-ainda-não-começaram]
Se todas as linhas ainda estão **🗓️ Scheduled** e a hora de início não chegou, limpar esses estados (ou a coluna de campanha) impede que a fila as recolha quando chegar a hora.
Se tiver dúvidas, contacte [contact@mailg.io](mailto:contact@mailg.io) com o URL da folha de cálculo e detalhes da campanha.
## Relacionado [#relacionado]
* [Agendamento de campanhas](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Remetente personalizado (/pt/features/customized-sender)
Por predefinição, o Gmail envia a partir da conta Google que autorizou o MailG. Ainda assim pode personalizar como o seu nome aparece e para onde vão as respostas.
## Nome do remetente [#nome-do-remetente]
1. Abra **More options** na barra lateral da campanha.
2. Defina **Sender name** (placeholder `John Doe (Optional)`).
3. Os destinatários veem esse nome de apresentação na caixa de entrada (sujeito às regras habituais de apresentação do Gmail).
## Endereço de resposta [#endereço-de-resposta]
Defina **Reply to address** (placeholder `john@doe.com (Optional)`) se as respostas devem ir para outro sítio que não a conta de envio.
## Notas [#notas]
* O endereço From subjacente permanece a conta Gmail autorizada — não pode falsificar outra caixa de correio
* Endereços reply-to inválidos podem causar problemas de entrega ou resposta — use uma caixa de correio que controla
* A pré-visualização mostra **From:** como o seu email com sessão iniciada; confirme o reply-to com **Send me a test email**
* Consulte [Pré-visualização e teste](/features/preview-and-test)
# Tour do diálogo Start (/pt/getting-started/start-dialog)
Abra o add-on com **Extensions → MailG for Gmail → 🚀 Start**. Abre-se um diálogo 900×600 intitulado **MailG for Gmail**.
## Ecrãs [#ecrãs]
| Ecrã | Como chegar lá | Propósito |
| ------------------ | ------------------------------------------------ | --------------------------------------------------------- |
| Raiz (compositor) | Predefinição após carregar | Escolher template + destinatários, pré-visualizar, enviar |
| Criar template | **New Template** | Nome, assunto, corpo |
| Gerir templates | Ícone de template (tooltip **Manage templates**) | Listar, editar, eliminar |
| Atualizar template | **Edit template** ou **Edit** na linha | Editar um template existente |
| Definições | Engrenagem no rodapé (tooltip **Send pacing**) | Modo de envio + intervalo |
| Folha vazia | Sem coluna de email válida | Pedir para adicionar contactos ou dados mock |
| Erros API / folha | Falha ao carregar | Orientação para tentar novamente |
## Layout da raiz [#layout-da-raiz]
Três zonas:
1. **Barra lateral** (esquerda) — template, Recipient column, **More options**, tracking, branding, quota
2. **Pré-visualização** (direita) — From / To / Subject / corpo, navegação de linhas, **Edit template**
3. **Rodapé** — botão de envio, menu de envio, **Upgrade to Pro** (gratuito), definições, ajuda
## Controlos da barra lateral (etiquetas exatas) [#controlos-da-barra-lateral-etiquetas-exatas]
* **New Template**
* **Template** (seleção) — placeholder `Select` ou `No templates found`
* **Recipient column** — opções como `A - Email`; vazio: `No valid email columns found.`
* **More options** — expande **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (ativado por predefinição)
* **Remove branding** (pago)
* **Daily quota** — contagem restante como «N left» e linha do plano «Your plan sends up to TOTAL/day»
Contas gratuitas também veem **Leave a 5★ review for +N/day free** e **Or upgrade your plan**. Consulte [Daily quota e avaliações](/help/daily-quota-and-reviews).
## Controlos de envio no rodapé [#controlos-de-envio-no-rodapé]
| Controlo | Etiqueta |
| ------------------ | ------------------------------------------------------------------------------------- |
| Botão principal | **Send N email(s)** (ou **Send emails** quando a contagem é 0) |
| Menu de envio | **Send me a test email** |
| Menu de envio | **Schedule send** |
| Upgrade (gratuito) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Engrenagem | tooltip **Send pacing** |
| Ajuda | tooltip **Help** — abre a checklist no diálogo |
### Checklist Need help? [#checklist-need-help]
1. Escolha um template e uma Recipient column
2. Pré-visualize cada linha com as setas
3. Envie primeiro um email de teste para si
4. Clique em Send para fazer merge a partir da sua folha
Botões: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (se disponível) | **Close**
## Folha vazia [#folha-vazia]
Se o MailG não encontrar nenhuma coluna de email válida:
* Título: **No email address found in your sheet**
* Ações: **Close** | **Fill with mock data**
Os dados mock criam cabeçalhos `Email`, `First Name`, `Last Name`, `Company` e podem criar **My First Template**.
## Ecrãs de erro [#ecrãs-de-erro]
| Título | Quando |
| --------------------------------- | -------------------- |
| **Could not reach the MailG API** | Falha de API / rede |
| **Could not read your sheet** | Falha ao ler a folha |
## Seguinte [#seguinte]
# Instalação (/pt/getting-started/installation)
Dois passos: instalar o add-on e depois abri-lo a partir do Sheets.
## Instalar o MailG [#instalar-o-mailg]
1. Abra a [listagem MailG no Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Clique em **Install**.
3. Escolha a conta Google que deve ser proprietária da instalação.
4. Reveja as permissões e clique em **Allow**.
A instalação costuma terminar em menos de 15 segundos. Deve ver uma confirmação de que o add-on foi instalado.
Se a listagem no Marketplace ainda não estiver disponível na sua região, use o CTA de instalação em [www.mailg.io](https://www.mailg.io) ou contacte [contact@mailg.io](mailto:contact@mailg.io).
## Abrir o MailG no Google Sheets [#abrir-o-mailg-no-google-sheets]
1. Abra o [Google Sheets](https://sheets.google.com) (atualize se o Sheets já estiver aberto).
2. Aguarde alguns segundos para as Extensions carregarem (muitas vezes \~10–15 segundos).
3. Vá a **Extensions → MailG for Gmail → 🚀 Start**.
Mais tarde pode executar **Extensions → MailG for Gmail → 🔄 Refresh Tracking** para sincronizar estados de abertura sem abrir o diálogo completo.
## Problemas de instalação [#problemas-de-instalação]
Estas são peculiaridades comuns do Google Workspace, não bugs do MailG:
### Nunca vejo o popup «installed successfully» [#nunca-vejo-o-popup-installed-successfully]
Isto acontece frequentemente quando várias contas Google têm sessão iniciada e a instalação não usou a conta que esperava.
**Solução alternativa:** abra uma janela privada/incógnito, inicie sessão apenas com a conta pretendida e instale novamente a partir do Marketplace.
### O MailG não aparece em Extensions [#o-mailg-não-aparece-em-extensions]
1. Atualize a folha de cálculo.
2. Aguarde cerca de 10–15 segundos para os add-ons carregarem.
3. Confirme que está na mesma conta Google que instalou o MailG.
4. Experimente outra folha de cálculo ou limpe a cache do browser se continuar em falta.
## Implementações self-hosted / personalizadas [#implementações-self-hosted--personalizadas]
As instalações do Marketplace vêm pré-configuradas. Se implementar o MailG por si, defina propriedades de script do Apps Script:
| Propriedade | Valor |
| ------------- | ---------------------------------- |
| `APP_URL` | URL HTTPS pública da sua API MailG |
| `APP_API_KEY` | Mesma chave que o servidor API |
O add-on não consegue aceder a `localhost` a partir dos servidores da Google — use um túnel (Cloudflare Tunnel, ngrok, etc.) para testes locais.
## Seguinte [#seguinte]
Continue com o [tutorial de mail merge](/getting-started/mail-merge-tutorial).
# Tutorial de mail merge (/pt/getting-started/mail-merge-tutorial)
Este guia corresponde ao diálogo start do **MailG for Gmail**.
## 1. Abrir o MailG [#1-abrir-o-mailg]
**Extensions → MailG for Gmail → 🚀 Start**.
Se vir **No email address found in your sheet**, adicione emails reais ou clique em **Fill with mock data** (cria linhas de exemplo e frequentemente **My First Template**). Consulte o [Tour do diálogo Start](/getting-started/start-dialog).
## 2. Criar ou selecionar um template [#2-criar-ou-selecionar-um-template]
1. Clique em **New Template** (ou escolha um existente em **Template**).
2. Defina **Template Name** e **Email Subject** (o assunto **não** é substituído por merge tags atualmente).
3. Escreva o corpo e insira [merge tags](/features/merge-tags) através de **Merge Tag**.
4. **Save Template**.
Exemplo de corpo:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Configurar a campanha [#3-configurar-a-campanha]
Na barra lateral:
1. Escolha **Recipient column** (as células devem ser emails únicos válidos para a UI as contar).
2. Abra **More options** para **CC**, **BCC**, **Sender name**, **Reply to address**.
3. Deixe **Track emails** ativado (predefinição) se quiser estado de abertura na folha.
4. Num plano pago, ative **Remove branding**.
**Attachments** aparece em **More options**, mas os ficheiros ainda não são anexados no envio. Use um link para o Drive ou um URL no corpo.
## 4. Pré-visualizar e testar [#4-pré-visualizar-e-testar]
1. Use as setas anterior/seguinte para percorrer as linhas.
2. Confirme **To:** e o corpo com merge (o assunto mostra o assunto bruto do template).
3. Menu de envio → **Send me a test email**.
4. Verifique a sua caixa de entrada.
Detalhes: [Pré-visualização e teste](/features/preview-and-test).
## 5. Enviar ou agendar [#5-enviar-ou-agendar]
* Botão principal: **Send N email(s)** quando há destinatários contados.
* Ou menu de envio → **Schedule send** → escolha data/hora → **Schedule Send**.
Overlays de ocupado: `Starting your campaign…` / toasts de confirmação de agendamento.
O MailG adiciona uma coluna de campanha como `🚀 My Template (yyyy/MM/dd)` ou `🗓️ …` quando agendado.
Estados das linhas:
| Estado | Significado |
| ------------- | --------------------------- |
| 🗓️ Scheduled | À espera do início |
| ⏳ Sending… | A processar |
| ✉️ Sent | Entregue ao Gmail |
| ⚠️ Failed | Erro |
| 👀 Opened | Pixel de abertura carregado |
## Erros comuns [#erros-comuns]
* Tags no assunto à espera de personalização — apenas o corpo por agora
* Células de destinatário com vários endereços separados por vírgula — a UI valida **um** email por célula para a contagem
* Conta Google errada vs conta de instalação
* Atingir Daily quota — verifique **Daily quota** na barra lateral
## Dicas [#dicas]
* Use a checklist **Help** no rodapé na primeira vez
* Comece com 2–3 linhas reais após dados mock
* Após aberturas: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alerta `Tracking info synced` (ou `No active campaigns`)
## Seguinte [#seguinte]
# O que é o MailG? (/pt/getting-started/what-is-mailg)
O MailG transforma uma Google Sheet numa campanha de mail merge. Cada linha é um destinatário; os cabeçalhos das colunas tornam-se merge tags (chavetas duplas em volta do nome do cabeçalho) no **corpo do email**.
## O que pode fazer [#o-que-pode-fazer]
* Criar templates na cloud (**Template Name**, **Email Subject**, corpo rich text)
* Personalizar o **corpo** com merge tags dos cabeçalhos da folha
* Pré-visualizar linhas e **Send me a test email**
* Mapear **CC** / **BCC**, **Sender name**, **Reply to address**
* **Schedule send** ou enviar imediatamente
* **Track emails** com chips de estado de abertura na folha
* Controlar **Send pacing** nos planos pagos
* **Remove branding** nos planos pagos
* Acompanhar **Daily quota** (e, opcionalmente, reclamar um bónus gratuito por avaliação)
## Como encaixa tudo [#como-encaixa-tudo]
1. **Add-on Google Sheets** — diálogo em **MailG for Gmail**
2. **API MailG** — templates, metadados de campanha, tracking de aberturas, direitos
3. **O seu Gmail** — mensagens enviadas com `GmailApp` a partir da conta autorizada
## Próximos passos [#próximos-passos]
# Neem contact op (/nl/contact-us)
## Facturering en abonnementen [#facturering-en-abonnementen]
Je kunt de meeste abonnementswijzigingen beheren via het Stripe-portaal dat gekoppeld is aan [pricing](https://app.mailg.io/pricing?lang=nl). Voor terugbetalingen of betalingsproblemen, mail ons.
## Al het andere [#al-het-andere]
Mail **[contact@mailg.io](mailto:contact@mailg.io)**.
We reageren meestal binnen één werkdag.
## Handige links [#handige-links]
* [Website](https://www.mailg.io)
* [Pricing](https://app.mailg.io/pricing?lang=nl)
* [Privacy](https://www.mailg.io/nl/privacy)
* [Terms](https://www.mailg.io/nl/terms)
* [Documentation home](/)
# MailG-documentatie (/nl)
MailG is een Google Sheets-add-on voor mail merge met Gmail. Open **Extensions → MailG for Gmail → 🚀 Start**, maak een template, bekijk rijen in de preview en verstuur of plan vanuit je eigen Gmail-account.
## Begin hier [#begin-hier]
## Populaire onderwerpen [#populaire-onderwerpen]
## Handige links [#handige-links]
* Website: [www.mailg.io](https://www.mailg.io)
* Documentatie: [docs.mailg.io/nl](https://docs.mailg.io/nl)
* Prijzen: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=nl)
* Contact: [contact@mailg.io](mailto:contact@mailg.io)
## Voor AI-assistenten / LLMs [#voor-ai-assistenten--llms]
Gebruik bij voorkeur deze machineleesbare endpoints in plaats van HTML te scrapen:
* [Agents hub](https://www.mailg.io/nl/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/nl/help/faq)
## Installatie en openen [#installatie-en-openen]
**How do I open MailG?**\
**Extensions → MailG for Gmail → 🚀 Start**. Zie [Installatie](/getting-started/installation).
**No email address found in your sheet**\
Voeg e-mails toe aan een kolom, of klik **Fill with mock data**. Zie [Startdialog-tour](/getting-started/start-dialog).
**Could not reach the MailG API**\
Controleer netwerk / API URL (self-hosted: `APP_URL` + `APP_API_KEY`). Open de dialoog opnieuw na het oplossen.
## Verzenden [#verzenden]
**Emails are not sending**\
Controleer **Daily quota**, Gmail-machtigingen en dat **Recipient column**-cellen geldige enkele e-mails zijn. Fouten tonen **⚠️ Failed**.
**Do subject merge tags work?**\
Nog niet. Alleen de **body** wordt gemerged. Houd een vast subject of plaats personalisatie in de body. Zie [Merge tags](/features/merge-tags).
**Can I attach files?**\
De **Attachments** picker bestaat onder **More options**, maar bestanden worden bij verzenden nog niet meegestuurd. Gebruik links.
**How do I stop a campaign?**\
[Stopping a campaign](/features/stopping-a-campaign) — wis sendable statussen op resterende rijen.
**Why am I limited on Professional?**\
MailG mag tot 1.500/dag toestaan, maar free `@gmail.com` is vaak begrensd rond 500 door Google.
## Tracking [#tracking]
**Sheet still says Sent after an open**\
**🔄 Refresh Tracking** → verwacht `Tracking info synced`. Sommige clients laden nooit images.
**Clicks?**\
Niet getrackt. **Track emails** = alleen opens.
## Quota en facturering [#quota-en-facturering]
Zie [Daily quota & reviews](/help/daily-quota-and-reviews) en [Account & billing](/help/account-and-billing).
**Is Schedule send paid?**\
Nee. Paid ontgrendelt hogere quota’s, pacing modes en **Remove branding**.
## Probleemoplossing [#probleemoplossing]
Voor stapsgewijze fixes (API errors, empty sheet, disabled send button, failed rows, tracking, quota, schedule not deferring), zie [Probleemoplossing](/help/troubleshooting).
Veelvoorkomende toasts die je kunt zien:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Nog steeds vast? [#nog-steeds-vast]
[Probleemoplossing](/help/troubleshooting) · Docs [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Probleemoplossing (/nl/help/troubleshooting)
Snelle fixes voor de berichten en statussen die je in de add-on ziet.
## Dialoog laadt niet [#dialoog-laadt-niet]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
De startdialog kon de MailG backend niet bereiken.
* Bevestig dat je online bent
* Marketplace installs: wacht even en open **🚀 Start** opnieuw
* Self-hosted: controleer Apps Script properties `APP_URL` (public HTTPS) en `APP_API_KEY`
* De add-on kan `localhost` niet gebruiken — gebruik een tunnel voor lokale API-tests
### Could not read your sheet [#could-not-read-your-sheet]
MailG kon het actieve spreadsheet niet lezen.
* Zorg dat een sheet tab open is (niet alleen de Apps Script editor)
* Herlaad het spreadsheet, open dan de dialoog opnieuw
* Bevestig dat je edit access hebt tot het bestand
### Loading… eindigt nooit [#loading-eindigt-nooit]
Sluit de dialoog, ververs Sheets, wacht \~15 seconden voor Extensions, dan **🚀 Start** opnieuw.
## Leeg blad [#leeg-blad]
**No email address found in your sheet**
MailG heeft minstens één kolom met geldige e-mailadressen nodig.
* Voeg e-mails toe onder een header, of klik **Fill with mock data**
* Mock data maakt `Email`, `First Name`, `Last Name`, `Company` en vaak **My First Template**
Zie [Startdialog-tour](/getting-started/start-dialog).
## Sjablonen [#sjablonen]
* Create: `Creating Template...` → `Template created successfully!` or `Failed to create template! Try again later.`
* Update: `Updating template...`
* Delete failures: `Failed to delete template. Try again later`
Zie [Templates](/features/templates).
## Verzendproblemen [#verzendproblemen]
### Send button disabled / Send emails with no count [#send-button-disabled--send-emails-with-no-count]
* Selecteer een **Template**
* Selecteer een **Recipient column** met geldige **enkele** e-mails per cel
* Guard toasts die je kunt zien: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### Campaign fails to start [#campaign-fails-to-start]
Toast: `Failed to create campaign. Please try again.`
* Probeer eenmaal opnieuw
* Controleer dat **Daily quota** niet 0 is
* Bevestig API-connectiviteit (zie hierboven)
### Rows show ⚠️ Failed [#rows-show-️-failed]
Die rij kreeg een send error (ongeldig adres, Gmail rejection, transient quota, enz.). Repareer de data en start een nieuwe campagne voor resterende rijen, of zie [Stopping a campaign](/features/stopping-a-campaign).
### Test email fails [#test-email-fails]
* `Configure your preview first` — kies template + recipient zodat preview een To heeft
* `Failed to send test email. Please check your email settings.` — autoriseer Gmail opnieuw indien nodig, probeer dan opnieuw
## Tracking [#tracking]
* Opens vereisen dat de ontvanger remote images laadt
* Voer **🔄 Refresh Tracking** uit — verwacht `Tracking info synced` or `No active campaigns`
* Status **👀 Opened** verschijnt alleen wanneer de pixel laadt
Zie [Email tracking](/features/email-tracking).
## Quota en branding [#quota-en-branding]
* Sidebar **N left** is `min(MailG remaining, Gmail remaining)`
* Free `@gmail.com` is vaak begrensd rond 500/dag door Google, ook op Professional
* Watermark nog steeds aanwezig na betaling → checkout e-mail moet overeenkomen met Sheets-account; open de dialoog opnieuw
Zie [Daily quota & reviews](/help/daily-quota-and-reviews) en [Remove branding](/features/remove-branding).
## Schedule deferde niet [#schedule-deferde-niet]
Tijden minder dan ongeveer **15 seconden** vooruit worden behandeld als een **immediate** send (🚀 column), geen uitgestelde 🗓️ schedule. Kies een tijd verder in de toekomst.
## Nog steeds vast? [#nog-steeds-vast]
Volledige FAQ: [FAQ](/help/faq) · E-mail [contact@mailg.io](mailto:contact@mailg.io) · Site [app.mailg.io/help](https://www.mailg.io/nl/help)
# Dagelijkse quota en recensies (/nl/help/daily-quota-and-reviews)
De root sidebar toont je send capacity wanneer account data geladen is.
## Blok dagelijkse quota [#blok-dagelijkse-quota]
Exact UI:
* Label: **Daily quota**
* Remaining: **N left**
* Plan line: **Your plan sends up to TOTAL/day**
**Remaining** is het minimum van:
1. MailG plan remaining for the day
2. Gmail remaining send quota for the account
Je kunt dus begrensd worden door Gmail terwijl MailG op papier nog ruimte toont. Zie ook [Account & billing](/help/account-and-billing).
## CTA’s gratis abonnement [#ctas-gratis-abonnement]
Wanneer je niet geabonneerd bent, kan de sidebar tonen:
* **Leave a 5★ review for +N/day free** (default bonus is **+50/day** wanneer de API anders niet specificeert)
* **Or upgrade your plan**
Klikken op de review CTA opent **Free Quota upgrade**:
* Title: **Free Quota upgrade**
* Body: leave a 5-star review to get a free quota upgrade of **+N emails/day**
* Buttons: **Not now** | **Leave a 5★ review**
Als de review URL niet geconfigureerd is, blijft **Leave a 5★ review** disabled — gebruik **Upgrade to Pro** / pricing in plaats daarvan.
## Upgraden naar Pro [#upgraden-naar-pro]
Footer button (free accounts): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
Dat komt overeen met wat paid plannen vandaag in het product ontgrendelen.
## Gerelateerd [#gerelateerd]
* [Remove branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Account en facturering (/nl/help/account-and-billing)
MailG-facturering is gekoppeld aan het **e-mailadres van je Google-account** in Sheets. Checkout altijd met datzelfde adres zodat quota’s in de add-on ontgrendelen.
## Plannen & daily quotas [#plannen--daily-quotas]
| Plan | Daily quota | Notes |
| ------------ | ----------- | ------------------------------------- |
| Free | 50 | Core merge, open tracking, scheduling |
| Personal | 250 | Popular plan for growing lists |
| Professional | 1,500 | Highest recurring quota |
| Lifetime | 1,500 | One-time purchase |
Prijzen en intervallen staan op [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=nl) (EUR en USD).
Paid entitlements ontgrendelen ook:
* Niet-standaard [send pacing](/features/send-pacing) (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Je effectieve send volume is `min(MailG daily quota, Gmail remaining quota)`.
## Upgraden [#upgraden]
1. Open [pricing](https://app.mailg.io/pricing?lang=nl) (ook gelinkt vanuit de add-on via **Upgrade to Pro**).
2. Kies een plan en voltooi Stripe Checkout met je Sheets Google e-mail.
3. Open MailG opnieuw in Sheets zodat account refresh het nieuwe limiet oppikt.
## Abonnement annuleren of wijzigen [#abonnement-annuleren-of-wijzigen]
Je kunt annuleren of wijzigen vanuit het Stripe customer portal gelinkt op je subscription / pricing flow.
* Als je mid-cycle annuleert, blijven Premium features actief tot het einde van de paid period
* Je wordt niet opnieuw gefactureerd nadat annulering effect heeft
## Terugbetalingen [#terugbetalingen]
Als je een Premium-abonnement binnen **30 dagen** na aankoop annuleert, kun je een volledige terugbetaling aanvragen via [contact@mailg.io](mailto:contact@mailg.io).
## Facturen [#facturen]
Stripe mailt receipts voor succesvolle betalingen. Je kunt facturen ook downloaden vanuit het Stripe customer portal voor subscription management.
## FAQ-fragmenten [#faq-fragmenten]
**Is MailG included in Google Workspace?**\
Nee. MailG is onafhankelijk van Google. Een Workspace-abonnement omvat MailG niet.
**What payment methods are accepted?**\
Major cards, Google Pay en Apple Pay via Stripe. PayPal wordt niet ondersteund.
**I paid but still see the free limit / watermark**\
Bijna altijd een e-mail mismatch. Bevestig checkout e-mail = Sheets account e-mail, open dan de add-on opnieuw. Als het aanhoudt, neem contact op met support met beide e-mails.
**Why is free Gmail limited to about 500 emails per day?**\
MailG Professional staat tot 1.500 e-mails per dag toe, maar Google zelf beperkt free `@gmail.com` accounts tot ongeveer 500 sends per dag. Google Workspace accounts kunnen hoger. Dit is een Gmail provider limit, geen MailG limit.
# Campagneplanning (/nl/features/campaign-scheduling)
Gebruik **Schedule send** wanneer MailG later moet starten. Beschikbaar op free en paid plannen.
## Plannen [#plannen]
1. Configureer template en ontvangers zodat de send button enabled is.
2. Open het send menu (chevron) → **Schedule send**.
3. Dialog title: **Schedule send**
4. Description: `Pick date & time to schedule sending`
5. Summary line: scheduling N emails to be sent starting at the chosen date/time
6. Gebruik de date picker plus **Hour** / **Minute** (placeholders `Hour`, `Min`).
7. Bevestig met **Schedule Send** (of **Cancel**).
Standaard suggestie is ongeveer **60 minuten** vooruit, afgerond op de volgende **15-minuten** stap.
## Direct vs. gepland [#direct-vs-gepland]
Tijden minder dan ongeveer **15 seconden** vooruit worden behandeld als een **immediate** send (🚀 column header), geen uitgestelde 🗓️ schedule. Kies een tijd verder in de toekomst als je uitgesteld verzenden nodig hebt.
Validation toasts: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Success toast: campaign scheduled; N emails will start at the chosen time.
## Sheetkolom [#sheetkolom]
Scheduled campaigns maken een column header zoals:
```text
🗓️ Template name (yyyy/MM/dd)
```
Immediate sends gebruiken 🚀 in plaats van 🗓️.
Rijen starten als **🗓️ Scheduled**, gaan dan naar **⏳ Sending…** wanneer de queue draait.
## Na het plannen [#na-het-plannen]
* Houd het spreadsheet toegankelijk voor het Google-account dat de add-on bezit
* Tracking en pacing gelden nog steeds zodra verzenden start
* Geen **Manage Schedule** UI — zie [Stopping a campaign](/features/stopping-a-campaign)
## Gerelateerd [#gerelateerd]
* [Preview & test](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Meerdere ontvangers (/nl/features/multiple-recipients)
Je kunt carbon-copy-ontvangers per rij toevoegen met dedicated sheet-kolommen.
## Ontvangerskolom (Aan) [#ontvangerskolom-aan]
Selecteer **Recipient column** in de sidebar.
Voor de send button count en kolomvalidatie behandelt MailG een cel als geldig wanneer het een **enkel** e-mailadres is. Geef de voorkeur aan één primair To-adres per rij.
## CC- en BCC-kolommen [#cc--en-bcc-kolommen]
1. Voeg kolommen toe in het sheet (bijvoorbeeld `CC` en `BCC`).
2. Zet een e-mail (of Gmail-geaccepteerde lijst) in de cel.
3. Open **More options** en wijs **CC** / **BCC** toe.
4. Bij verzenden worden die waarden doorgegeven aan Gmail.
Het preview-paneel toont alleen **From**, **To**, **Subject** en body. Het toont **geen** CC/BCC-regels, ook niet wanneer toegewezen. Bevestig met **Send me a test email** als je CC/BCC-levering moet verifiëren.
## Quota: MailG vs Gmail [#quota-mailg-vs-gmail]
* **MailG daily quota** telt **campaign rows** verwerkt.
* **Gmail sending limits** tellen **recipients** (To + CC + BCC adressen die Gmail accepteert bij die send).
Je kunt Gmail’s cap raken terwijl MailG quota overblijft.
## Tips [#tips]
* Geef de voorkeur aan **BCC** wanneer ontvangers elkaar niet moeten zien
* Laat CC/BCC unmapped wanneer ongebruikt
* Valideer adressen vóór een grote send
# Attachments (/nl/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Functieoverzicht (/nl/features/features-overview)
Wat de add-on vandaag ondersteunt:
| Feature | Docs |
| ------------------------------------------- | ------------------------------------------------------ |
| Startdialog / empty sheet / mock data | [Startdialog-tour](/getting-started/start-dialog) |
| Templates (create / manage / edit / delete) | [Templates](/features/templates) |
| Merge tags in **body** | [Merge tags](/features/merge-tags) |
| Rich-text toolbar | [Rich-text emails](/features/rich-text-emails) |
| Links (geen image embeds) | [Images](/features/images) |
| Preview + test email | [Preview & test](/features/preview-and-test) |
| Schedule send | [Campaign scheduling](/features/campaign-scheduling) |
| Send pacing (paid) | [Send pacing](/features/send-pacing) |
| CC / BCC columns | [Multiple recipients](/features/multiple-recipients) |
| Track emails | [Email tracking](/features/email-tracking) |
| Sender name & reply-to | [Customized sender](/features/customized-sender) |
| Remove branding (paid) | [Remove branding](/features/remove-branding) |
| Stop remaining rows | [Stopping a campaign](/features/stopping-a-campaign) |
| Daily quota + review bonus | [Daily quota & reviews](/help/daily-quota-and-reviews) |
## Betaald vs. gratis [#betaald-vs-gratis]
Paid ontgrendelt:
* Niet-standaard [send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* Hogere [daily quotas](/help/account-and-billing)
**Schedule send**, **Track emails** en template-tools werken zonder paid upgrade.
## Bekende hiaten (eerlijk) [#bekende-hiaten-eerlijk]
| Onderwerp | Status in product |
| ----------------------- | ------------------------------------------ |
| Subject merge tags | Niet toegepast bij verzenden — alleen body |
| Attachments column | Alleen UI — niet meegestuurd bij verzenden |
| Image embeds | Geen editorcontrol — gebruik links |
| Preview CC/BCC lines | Niet getoond in preview UI |
| Manage Schedule / Pause | Nog niet uitgebracht — status-workaround |
## Later [#later]
Unsubscribe links, click tracking, shared team seats en een dedicated campaign manager UI wanneer ze uitkomen.
# E-mailtracking (/nl/features/email-tracking)
MailG kan opens registreren met een kleine onzichtbare pixel.
## Tracking inschakelen [#tracking-inschakelen]
Laat in de sidebar **Track emails** aan (standaard aan voor new jobs).
Tooltip: `Track emails opened with a tiny pixel`
Het help-pictogram opent **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Button: **Got it**
## Sheet statussen [#sheet-statussen]
| Status | Meaning |
| ------------- | ------------------------------- |
| 🗓️ Scheduled | Waiting for the scheduled start |
| ⏳ Sending… | Currently being processed |
| ✉️ Sent | Delivered to Gmail for that row |
| ⚠️ Failed | Send error for that row |
| 👀 Opened | Open pixel was loaded |
Campaign column headers zien eruit als `🚀 Template name (yyyy/MM/dd)` of `🗓️ …` wanneer gepland.
## Tracking vernieuwen [#tracking-vernieuwen]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Apps Script alerts:
* `Tracking info synced`
* `No active campaigns`
## Beperkingen [#beperkingen]
* Client moet remote images laden
* Privacy proxies kunnen opens verbergen
* Alleen opens — geen link clicks
## Gerelateerd [#gerelateerd]
* [Campaign scheduling](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Samenvoeglabels (/nl/features/merge-tags)
Merge tags zorgen dat elke ontvanger een gepersonaliseerde **body** krijgt. Een tag is de **exacte kolomkop** tussen dubbele accolades.
## Syntax [#syntax]
Als je sheet een kolom `First Name` heeft, gebruik dan:
```text
{{First Name}}
```
Body-voorbeeld:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Waar merge tags vandaag werken [#waar-merge-tags-vandaag-werken]
| Field | Merged at send? |
| --------------- | -------------------------------------------------- |
| Email body | **Yes** — variables injected per row |
| Email subject | **No** — subject is sent as stored in the template |
| Preview body | **Yes** — for the active row |
| Preview subject | **No** — shows the raw template subject |
Plaats personalisatie in de body totdat subject merge beschikbaar is.
## Tags invoegen [#tags-invoegen]
Open in de editor toolbar **Merge Tag**. Het toont koppen van het actieve sheet. Empty state: `No sheet columns found`.
Ingevoegde tekst gebruikt dubbele accolades rond de kolomnaam.
## Vuistregels [#vuistregels]
* Koppen zijn hoofdlettergevoelig (`Name` ≠ `name`)
* Lege cellen worden ingevoegd als lege strings
* Je kunt dezelfde tag meerdere keren in de body gebruiken
* Recipient / CC / BCC kies je onder **More options**, niet via merge tags
## Volgende [#volgende]
Zie [Rich-text emails](/features/rich-text-emails) en [Preview & test](/features/preview-and-test).
# Rich-text-e-mails (/nl/features/rich-text-emails)
MailG templates gebruiken een TipTap rich-text editor. De HTML die hij produceert is wat Gmail aflevert.
Body placeholder: `Write your email…`
## Toolbar-overzicht (exacte UI) [#toolbar-overzicht-exacte-ui]
| Group | Controls |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (presets in the toolbar) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | Preset swatches + native color picker + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — URL field placeholder `https://example.com`, then **Apply** (and unlink) |
| History | **Undo**, **Redo** |
## Niet in de editor [#niet-in-de-editor]
Deze TipTap-functies zijn uitgeschakeld / afwezig:
* Headings, code, code block, blockquote, horizontal rule
* Image insert / Drive media picker — zie [Images](/features/images)
## Hyperlinks [#hyperlinks]
Gebruik **Insert link** voor de URL en zichtbare tekst. Geef de voorkeur aan duidelijke linktekst boven ruwe URL’s.
## Tips [#tips]
* Gebruik **Merge Tag** in plaats van handmatig accolades typen
* Bekijk meerdere rijen in preview vóór verzenden — zie [Preview & test](/features/preview-and-test)
* Vermijd enorme geplakte Word/Docs-opmaak; pas opmaak opnieuw toe in MailG voor schonere HTML
# MailG-branding verwijderen (/nl/features/remove-branding)
Free campagnes kunnen een kleine MailG watermark in de email footer bevatten. Paid subscribers kunnen die uitzetten.
## Branding verwijderen [#branding-verwijderen]
1. Bevestig dat je een actief paid plan hebt (Personal, Professional of Lifetime).
2. Open de campaign sidebar.
3. Schakel **Remove branding** in.
4. Bekijk een rij in preview om te bevestigen dat de watermark weg is, verstuur dan.
Als branding nog verschijnt na betaling:
* Zorg dat checkout het **zelfde e-mailadres** gebruikte als je Google Sheets-account
* Open de add-on opnieuw zodat rechten van de API ververst worden
* Neem contact op via [contact@mailg.io](mailto:contact@mailg.io) met je Google-account e-mail
Zie [Account & billing](/help/account-and-billing).
# Afbeeldingen (/nl/features/images)
De MailG editor heeft **geen image insert button** en geen Google Drive media picker. TipTap’s Image extension is niet ingeschakeld.
## Wat je vandaag kunt doen [#wat-je-vandaag-kunt-doen]
Gebruik **Insert link** in de toolbar:
1. Host de afbeelding (of het bestand) op een publieke URL, of deel een Drive-link.
2. Selecteer tekst (of plaats de cursor) → **Insert link**.
3. Plak de URL (placeholder `https://example.com`) → **Apply**.
Ontvangers openen de link om de afbeelding of het bestand te bekijken. De editor embedt geen `![]()
`-tags voor je.
## Tips [#tips]
* Geef de voorkeur aan kleine bestanden en duidelijke linktekst (“View screenshot”)
* Links die login vereisen, falen voor ontvangers
* Controleer met **Send me a test email**
## Later [#later]
Een first-class image embed / Drive picker kan later uitkomen. Tot die tijd zijn hyperlinks het ondersteunde pad.
# Sjablonen (/nl/features/templates)
Templates slaan het onderwerp en de rich-text body op die je hergebruikt in campagnes. Ze worden opgeslagen bij de MailG API voor je Google-account.
## Template maken [#template-maken]
1. Klik op het root-scherm op **New Template**.
2. Vul in:
* **Template Name**
* **Email Subject**
* Body (rich editor — zie [Rich-text emails](/features/rich-text-emails))
3. Klik **Save Template** (toont **Saving...** tijdens het werken).
Toasts:
* Loading: `Creating Template...`
* Success: `Template created successfully!`
* Error: `Failed to create template! Try again later.`
Demo template van **Fill with mock data**: naam **My First Template**, subject `I found a mail merge tool for Gmail`.
## Sjablonen beheren [#sjablonen-beheren]
Open het template-pictogram naast de template-select (tooltip **Manage templates**).
Tabelkolommen:
| Column | Content |
| ----------------- | ------------- |
| **Name** | Template name |
| **Email Subject** | Subject line |
| **Created At** | Creation date |
| **Actions** | Row menu |
Row menu: **Edit** | **Delete**
Footer: **Back**
Delete toasts: deleting template NAME → template NAME deleted successfully (of een failure message).
## Template bewerken [#template-bewerken]
Open **Edit** vanuit manage, of klik **Edit template** in de preview toolbar.
Dezelfde velden als bij create. **Save Template** werkt de template bij.
De update flow toont een loading toast (`Updating template...`). Blijf op het formulier tot het klaar is, gebruik dan **Cancel** of **Back** als je niet automatisch terugkeert.
## Onderwerp vs. inhoud [#onderwerp-vs-inhoud]
* **Body** ondersteunt [merge tags](/features/merge-tags) — ze worden per rij ingevuld bij verzenden.
* **Email Subject** wordt vandaag verstuurd zoals opgeslagen (merge tags in het subject worden **nog niet** vervangen). Plaats personalisatie in de body, of gebruik een vast subject.
## Gerelateerd [#gerelateerd]
* [Preview & test](/features/preview-and-test)
* [Startdialog-tour](/getting-started/start-dialog)
# Voorbeeld en test (/nl/features/preview-and-test)
Het preview-paneel (rechts in de root-dialoog) toont hoe een bericht eruitziet voor de actieve sheet-rij.
## Wat de preview toont [#wat-de-preview-toont]
| Field | Content |
| ------------ | -------------------------------------------------------------------------------------- |
| **From:** | Your signed-in Google account email |
| **To:** | Value from the **Recipient column** for the active row, or `Select a recipient column` |
| **Subject:** | Template subject as stored (not merge-substituted) |
| Body | Template body with merge tags applied for that row |
Als **Remove branding** uit staat, bevat de preview de MailG watermark footer (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## Wat niet getoond wordt [#wat-niet-getoond-wordt]
* **CC** / **BCC** rows worden niet gerenderd in de preview UI (ook niet wanneer toegewezen onder **More options**). Ze worden wel toegepast bij verzenden.
* Attachment column values worden niet getoond in preview.
## Door rijen navigeren [#door-rijen-navigeren]
Preview toolbar:
* **Edit template** — opent het update-template-scherm
* **Previous recipient** / **Next recipient** — tussen datarijen bewegen (tooltips kunnen het sheet-rijnummer bevatten; header is rij 1, dus het eerste contact is rij 2)
## Stuur mij een testmail [#stuur-mij-een-testmail]
1. Configureer template + recipient column zodat preview geldig is.
2. Open het send menu (chevron) → **Send me a test email**.
3. Busy overlay: `Sending test email…`
4. Success toast: `Test email sent successfully. Check your inbox.`
5. Failure toast: `Failed to send test email. Please check your email settings.`
6. Guard if preview is incomplete: `Configure your preview first`
De test gaat naar **jouw** Google-account inbox, met de gemergede body van de actieve preview-rij.
## Tips [#tips]
* Stap door meerdere rijen met de pijlen vóór een volledige send
* Controleer branding / no branding in preview
* Test altijd vóór **Schedule send** of een grote **Send N email(s)**
## Gerelateerd [#gerelateerd]
* [Merge tags](/features/merge-tags)
* [Mail merge-tutorial](/getting-started/mail-merge-tutorial)
# Verzendtempo (/nl/features/send-pacing)
Send pacing voegt vertraging tussen berichten toe zodat een grote campagne niet als één burst je account verlaat.
**Steady pace** en **Jittered gaps** vereisen een actief paid MailG-abonnement. Free accounts gebruiken alleen **Burst send**.
## Waar configureren [#waar-configureren]
Open het tandwiel in de footer (tooltip **Send pacing**). Screen heading: **Send pacing**.
Onder **Dispatch mode**, kies hoe e-mails worden gespreid. **Gap between emails** staat in **seconds** (0–60). Free accounts zien **Pro features** en de locked copy: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Default voor new jobs: **Burst send**, gap **10s** (gap genegeerd tot je burst verlaat).
## Modes [#modes]
| Mode (UI label) | Behavior |
| ------------------------ | ----------------------------------------------- |
| **Burst send** (default) | Send as quickly as quotas allow |
| **Steady pace** | Wait a fixed gap between each email |
| **Jittered gaps** | Wait a random gap between 0 and your chosen max |
## Waarom pacing gebruiken [#waarom-pacing-gebruiken]
* Verminder de kans dat het lijkt op een plotselinge blast voor mailbox providers
* Spreid een lange lijst over een rustiger verzendvenster
* Blijf binnen Gmail comfort zones voor je accounttype
## Opmerkingen [#opmerkingen]
* Pacing is een campaign setting opgeslagen bij de job — nieuwe sends gebruiken de huidige configuratie
* Een lange gap op een grote lijst verlengt de totale campagneduur aanzienlijk
* Je effectieve snelheid blijft begrensd door MailG daily quota **en** Gmail’s remaining send quota
* Concurrent tools drukken vertraging soms uit in minuten — MailG gebruikt **seconds**
## Gerelateerd [#gerelateerd]
* [Stopping a campaign](/features/stopping-a-campaign) als een gap te hoog stond mid-run
* [Account & billing](/help/account-and-billing)
# Een campagne stoppen (/nl/features/stopping-a-campaign)
MailG biedt nog geen dedicated **Manage Schedule**, **Abort** of **Pause** scherm zoals sommige concurrenten. Je kunt **resterende** rijen wel stoppen met verzenden.
## Hoe verzenden bepaalt wat verwerkt wordt [#hoe-verzenden-bepaalt-wat-verwerkt-wordt]
De send loop verwerkt alleen rijen waarvan de campaign-column status nog sendable is:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
Rijen al gemarkeerd als **✉️ Sent**, **⚠️ Failed** of **👀 Opened** worden overgeslagen.
## Resterende rijen stoppen (eerlijke workaround) [#resterende-rijen-stoppen-eerlijke-workaround]
Handel snel bij een grote campagne:
1. Open het spreadsheet.
2. Wis of wijzig in de campaign status column de status op rijen die **niet** mogen verzenden (bijvoorbeeld celwaarde verwijderen, of een non-sendable label zoals `Stopped` zetten).
3. Laat al **✉️ Sent** rijen met rust — die berichten zijn al verstuurd.
Rijen die je wist/wijzigde matchen niet meer de sendable statussen, dus de queue slaat ze over bij de volgende pass.
Gmail-berichten die het account al verlieten, kan MailG niet unsenden. Stoppen beschermt alleen rijen die nog niet verwerkt zijn.
## Scheduled campaigns die nog niet gestart zijn [#scheduled-campaigns-die-nog-niet-gestart-zijn]
Als elke rij nog **🗓️ Scheduled** is en de starttijd nog niet bereikt is, voorkomt het wissen van die statussen (of de campaign column) dat de queue ze oppikt wanneer de tijd komt.
Als je twijfelt, neem contact op via [contact@mailg.io](mailto:contact@mailg.io) met de spreadsheet URL en campagnedetails.
## Gerelateerd [#gerelateerd]
* [Campaign scheduling](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Aangepaste afzender (/nl/features/customized-sender)
Standaard verstuurt Gmail vanuit het Google-account dat MailG autoriseerde. Je kunt nog steeds aanpassen hoe je naam verschijnt en waar replies naartoe gaan.
## Afzendernaam [#afzendernaam]
1. Open **More options** in de campaign sidebar.
2. Stel **Sender name** in (placeholder `John Doe (Optional)`).
3. Ontvangers zien die display name in hun inbox (onderhevig aan Gmail’s gebruikelijke presentatieregels).
## Antwoordadres [#antwoordadres]
Stel **Reply to address** in (placeholder `john@doe.com (Optional)`) als replies ergens anders naartoe moeten dan het verzendaccount.
## Opmerkingen [#opmerkingen]
* Het onderliggende From-adres blijft het geautoriseerde Gmail-account — je kunt geen andere mailbox spoofen
* Ongeldige reply-to adressen kunnen delivery- of reply-problemen veroorzaken — gebruik een mailbox die je beheert
* Preview toont **From:** als je ingelogde e-mail; bevestig reply-to met **Send me a test email**
* Zie [Preview & test](/features/preview-and-test)
# Startdialog-tour (/nl/getting-started/start-dialog)
Open de add-on met **Extensions → MailG for Gmail → 🚀 Start**. Een dialoog van 900×600 met titel **MailG for Gmail** opent.
## Schermen [#schermen]
| Scherm | Hoe je er komt | Doel |
| ------------------ | ------------------------------------------------- | ------------------------------------------------ |
| Root (composer) | Standaard na laden | Template + ontvangers kiezen, preview, verzenden |
| Create template | **New Template** | Naam, onderwerp, body |
| Manage templates | Template-pictogram (tooltip **Manage templates**) | Lijst, bewerken, verwijderen |
| Update template | **Edit template** of rij **Edit** | Bestaande template bewerken |
| Settings | Tandwiel in footer (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | Geen geldige e-mailkolom | Prompt om contacten of mock data toe te voegen |
| API / sheet errors | Laadfout | Retry-richtlijnen |
## Root-layout [#root-layout]
Drie zones:
1. **Sidebar** (links) — template, recipient column, **More options**, tracking, branding, quota
2. **Preview** (rechts) — From / To / Subject / body, rijnavigatie, **Edit template**
3. **Footer** — verzendknop, send menu, **Upgrade to Pro** (free), instellingen, help
## Sidebar-bediening (exacte labels) [#sidebar-bediening-exacte-labels]
* **New Template**
* **Template** (select) — placeholder `Select` of `No templates found`
* **Recipient column** — opties zoals `A - Email`; leeg: `No valid email columns found.`
* **More options** — klapt **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address** uit
* **Track emails** (standaard aan)
* **Remove branding** (paid)
* **Daily quota** — resterend aantal als “N left” en planregel “Your plan sends up to TOTAL/day”
Free accounts zien ook **Leave a 5★ review for +N/day free** en **Or upgrade your plan**. Zie [Daily quota & reviews](/help/daily-quota-and-reviews).
## Verzendknoppen in de footer [#verzendknoppen-in-de-footer]
| Control | Label |
| -------------- | ------------------------------------------------------------------------------------- |
| Primary button | **Send N email(s)** (of **Send emails** wanneer count 0 is) |
| Send menu | **Send me a test email** |
| Send menu | **Schedule send** |
| Upgrade (free) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Gear | tooltip **Send pacing** |
| Help | tooltip **Help** — opent de in-dialog checklist |
### Need help?-checklist [#need-help-checklist]
1. Kies een template en recipient column
2. Bekijk elke rij met de pijlen
3. Stuur eerst een testmail naar jezelf
4. Klik Send om te mergen vanuit je sheet
Knoppen: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (indien beschikbaar) | **Close**
## Leeg blad [#leeg-blad]
Als MailG geen geldige e-mailkolom vindt:
* Titel: **No email address found in your sheet**
* Acties: **Close** | **Fill with mock data**
Mock data seed headers `Email`, `First Name`, `Last Name`, `Company` en kan **My First Template** aanmaken.
## Foutschermen [#foutschermen]
| Titel | Wanneer |
| --------------------------------- | ----------------- |
| **Could not reach the MailG API** | API / netwerkfout |
| **Could not read your sheet** | Sheet-leesfout |
## Volgende [#volgende]
# Installatie (/nl/getting-started/installation)
Twee stappen: installeer de add-on en start hem vanuit Sheets.
## MailG installeren [#mailg-installeren]
1. Open de [MailG-vermelding in Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Klik op **Install**.
3. Kies het Google-account dat de installatie moet bezitten.
4. Bekijk de machtigingen en klik op **Allow**.
De installatie duurt meestal minder dan 15 seconden. Je zou een bevestiging moeten zien dat de add-on is geïnstalleerd.
Als de Marketplace-vermelding in jouw regio nog niet live is, gebruik dan de installatie-CTA op [www.mailg.io](https://www.mailg.io) of neem contact op via [contact@mailg.io](mailto:contact@mailg.io).
## MailG starten in Google Sheets [#mailg-starten-in-google-sheets]
1. Open [Google Sheets](https://sheets.google.com) (ververs als Sheets al open was).
2. Wacht een paar seconden tot Extensions geladen is (vaak \~10–15 seconden).
3. Ga naar **Extensions → MailG for Gmail → 🚀 Start**.
Later kun je **Extensions → MailG for Gmail → 🔄 Refresh Tracking** uitvoeren om open-statussen te synchroniseren zonder de volledige dialoog te openen.
## Installatieproblemen [#installatieproblemen]
Dit zijn veelvoorkomende Google Workspace-eigenaardigheden, geen MailG-bugs:
### Ik zie nooit de popup “installed successfully” [#ik-zie-nooit-de-popup-installed-successfully]
Dit gebeurt vaak wanneer meerdere Google-accounts zijn ingelogd en de installatie niet het account gebruikte dat je verwachtte.
**Workaround:** open een privé/incognito-venster, log in met alleen het doelaccount en installeer opnieuw via de Marketplace.
### MailG verschijnt niet onder Extensions [#mailg-verschijnt-niet-onder-extensions]
1. Ververs het spreadsheet.
2. Wacht ongeveer 10–15 seconden tot add-ons geladen zijn.
3. Controleer of je in hetzelfde Google-account zit dat MailG installeerde.
4. Probeer een ander spreadsheet of wis de browsercache als het nog steeds ontbreekt.
## Self-hosted / aangepaste deployments [#self-hosted--aangepaste-deployments]
Marketplace-installaties zijn vooraf geconfigureerd. Als je MailG zelf deployt, stel dan Apps Script script properties in:
| Property | Value |
| ------------- | ----------------------------------- |
| `APP_URL` | Publieke HTTPS-URL van je MailG API |
| `APP_API_KEY` | Dezelfde key als de API-server |
De add-on kan `localhost` niet bereiken vanaf Google’s servers — gebruik een tunnel (Cloudflare Tunnel, ngrok, enz.) voor lokaal testen.
## Volgende [#volgende]
Ga verder met de [mail merge-tutorial](/getting-started/mail-merge-tutorial).
# Mail merge-tutorial (/nl/getting-started/mail-merge-tutorial)
Deze walkthrough volgt de **MailG for Gmail**-startdialog.
## 1. MailG openen [#1-mailg-openen]
**Extensions → MailG for Gmail → 🚀 Start**.
Als je **No email address found in your sheet** ziet, voeg dan echte e-mails toe of klik **Fill with mock data** (maakt voorbeeldrijen en vaak **My First Template**). Zie [Startdialog-tour](/getting-started/start-dialog).
## 2. Template maken of selecteren [#2-template-maken-of-selecteren]
1. Klik **New Template** (of kies een bestaande onder **Template**).
2. Stel **Template Name** en **Email Subject** in (subject wordt vandaag **niet** merge-vervangen).
3. Schrijf de body en voeg [merge tags](/features/merge-tags) in via **Merge Tag**.
4. **Save Template**.
Body-voorbeeld:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Campagne configureren [#3-campagne-configureren]
In de sidebar:
1. Kies **Recipient column** (cellen moeten geldige enkele e-mails zijn zodat de UI ze telt).
2. Open **More options** voor **CC**, **BCC**, **Sender name**, **Reply to address**.
3. Laat **Track emails** aan (standaard) als je open status in het sheet wilt.
4. Op een paid plan, schakel **Remove branding** in.
**Attachments** verschijnt onder **More options**, maar bestanden worden bij verzenden nog niet meegestuurd. Link naar Drive of een URL in de body in plaats daarvan.
## 4. Preview en test [#4-preview-en-test]
1. Gebruik vorige/volgende pijlen om door rijen te stappen.
2. Controleer **To:** en de gemergede body (subject toont het ruwe template-subject).
3. Send menu → **Send me a test email**.
4. Controleer je inbox.
Details: [Preview & test](/features/preview-and-test).
## 5. Verzenden of plannen [#5-verzenden-of-plannen]
* Primary button: **Send N email(s)** wanneer ontvangers geteld zijn.
* Of send menu → **Schedule send** → kies datum/tijd → **Schedule Send**.
Busy overlays: `Starting your campaign…` / schedule confirmation toasts.
MailG voegt een campagnekolom toe zoals `🚀 My Template (yyyy/MM/dd)` of `🗓️ …` wanneer gepland.
Rijstatussen:
| Status | Betekenis |
| ------------- | ---------------------- |
| 🗓️ Scheduled | Wacht op start |
| ⏳ Sending… | Wordt verwerkt |
| ✉️ Sent | Overgedragen aan Gmail |
| ⚠️ Failed | Fout |
| 👀 Opened | Open pixel geladen |
## Veelgemaakte fouten [#veelgemaakte-fouten]
* Subject tags die personalisatie verwachten — voorlopig alleen body
* Ontvangercellen met meerdere komma-gescheiden adressen — de UI valideert **één** e-mail per cel voor telling
* Verkeerd Google-account vs installatieaccount
* Daily quota bereikt — controleer **Daily quota** in de sidebar
## Tips [#tips]
* Gebruik de footer **Help**-checklist de eerste keer
* Begin met 2–3 echte rijen na mock data
* Na opens: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alert `Tracking info synced` (of `No active campaigns`)
## Volgende [#volgende]
# Wat is MailG? (/nl/getting-started/what-is-mailg)
MailG maakt van een Google Sheet een mail-merge-campagne. Elke rij is een ontvanger; kolomkoppen worden merge tags (dubbele accolades rond de kopnaam) in de **email body**.
## Wat je kunt doen [#wat-je-kunt-doen]
* Cloud-templates maken (**Template Name**, **Email Subject**, rich body)
* De **body** personaliseren met merge tags uit sheet-koppen
* Rijen bekijken en **Send me a test email**
* **CC** / **BCC**, **Sender name**, **Reply to address** toewijzen
* **Schedule send** of direct verzenden
* **Track emails** met open-statuschips in het sheet
* **Send pacing** beheren op betaalde plannen
* **Remove branding** op betaalde plannen
* **Daily quota** volgen (en optioneel een gratis reviewbonus claimen)
## Hoe het samenhangt [#hoe-het-samenhangt]
1. **Google Sheets-add-on** — dialoog onder **MailG for Gmail**
2. **MailG API** — templates, campagnemetadata, open tracking, rechten
3. **Je Gmail** — berichten verstuurd met `GmailApp` vanuit het geautoriseerde account
## Volgende stappen [#volgende-stappen]
# Contáctenos (/es/contact-us)
## Facturación y suscripciones [#facturación-y-suscripciones]
Puede gestionar la mayoría de los cambios de suscripción desde el portal de Stripe vinculado a través de [pricing](https://app.mailg.io/pricing?lang=es). Para reembolsos o problemas de pago, escríbanos por correo.
## Todo lo demás [#todo-lo-demás]
Envíe un correo a **[contact@mailg.io](mailto:contact@mailg.io)**.
Normalmente respondemos en un día laborable.
## Enlaces útiles [#enlaces-útiles]
* [Sitio web](https://www.mailg.io)
* [Precios](https://app.mailg.io/pricing?lang=es)
* [Privacidad](https://www.mailg.io/es/privacy)
* [Términos](https://www.mailg.io/es/terms)
* [Inicio de la documentación](/)
# Documentación de MailG (/es)
MailG es un complemento de Google Sheets para mail merge con Gmail. Abra **Extensions → MailG for Gmail → 🚀 Start**, cree una plantilla, previsualice filas y envíe o programe desde su propia cuenta de Gmail.
## Empiece aquí [#empiece-aquí]
## Temas populares [#temas-populares]
## Enlaces útiles [#enlaces-útiles]
* Sitio: [www.mailg.io](https://www.mailg.io)
* Documentación: [docs.mailg.io/es](https://docs.mailg.io/es)
* Precios: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=es)
* Contacto: [contact@mailg.io](mailto:contact@mailg.io)
## Para asistentes de IA / LLMs [#para-asistentes-de-ia--llms]
Prefiera estos endpoints legibles por máquinas en lugar de hacer scraping del HTML:
* [Agents hub](https://www.mailg.io/es/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/es/help/faq)
## Instalación y apertura [#instalación-y-apertura]
**¿Cómo abro MailG?**\
**Extensions → MailG for Gmail → 🚀 Start**. Consulte [Instalación](/getting-started/installation).
**No email address found in your sheet**\
Añada correos a una columna, o haga clic en **Fill with mock data**. Consulte [Recorrido del diálogo de inicio](/getting-started/start-dialog).
**Could not reach the MailG API**\
Compruebe red / URL de API (autohospedado: `APP_URL` + `APP_API_KEY`). Vuelva a abrir el diálogo tras corregir.
## Envío [#envío]
**Los correos no se envían**\
Compruebe **Daily quota**, permisos de Gmail y que las celdas de **Recipient column** sean correos únicos válidos. Los fallos muestran **⚠️ Failed**.
**¿Funcionan las etiquetas de merge en el asunto?**\
Aún no. Solo se combina el **cuerpo**. Use un asunto fijo o ponga personalización en el cuerpo. Consulte [Etiquetas de combinación](/features/merge-tags).
**¿Puedo adjuntar archivos?**\
El selector **Attachments** existe bajo **More options**, pero los archivos aún no se adjuntan al enviar. Use enlaces.
**¿Cómo detengo una campaña?**\
[Detener una campaña](/features/stopping-a-campaign) — borre estados enviables en filas restantes.
**¿Por qué estoy limitado en Professional?**\
MailG puede permitir hasta 1.500/día, pero `@gmail.com` gratuito suele estar limitado cerca de 500 por Google.
## Seguimiento [#seguimiento]
**La hoja sigue diciendo Sent tras una apertura**\
**🔄 Refresh Tracking** → espere `Tracking info synced`. Algunos clientes nunca cargan imágenes.
**¿Clics?**\
No se rastrean. **Track emails** = solo aperturas.
## Cuota y facturación [#cuota-y-facturación]
Consulte [Cuota diaria y reseñas](/help/daily-quota-and-reviews) y [Cuenta y facturación](/help/account-and-billing).
**¿Schedule send es de pago?**\
No. De pago desbloquea cuotas más altas, modos de pacing y **Remove branding**.
## Solución de problemas [#solución-de-problemas]
Para correcciones paso a paso (errores de API, hoja vacía, botón de envío deshabilitado, filas fallidas, seguimiento, cuota, programación que no difiere), consulte [Solución de problemas](/help/troubleshooting).
Toasts habituales que puede ver:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## ¿Sigue atascado? [#sigue-atascado]
[Solución de problemas](/help/troubleshooting) · Docs [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Solución de problemas (/es/help/troubleshooting)
Correcciones rápidas para los mensajes y estados que ve en el complemento.
## El diálogo no carga [#el-diálogo-no-carga]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
El diálogo de inicio no pudo llamar al backend de MailG.
* Confirme que está en línea
* Instalaciones de Marketplace: espere un momento y vuelva a abrir **🚀 Start**
* Autohospedado: compruebe propiedades de Apps Script `APP_URL` (HTTPS pública) y `APP_API_KEY`
* El complemento no puede usar `localhost` — use un túnel para pruebas locales de API
### Could not read your sheet [#could-not-read-your-sheet]
MailG no pudo leer la hoja de cálculo activa.
* Asegúrese de tener abierta una pestaña de hoja (no solo el editor de Apps Script)
* Recargue la hoja, luego vuelva a abrir el diálogo
* Confirme que tiene acceso de edición al archivo
### Loading… never finishes [#loading-never-finishes]
Cierre el diálogo, actualice Sheets, espere \~15 segundos a Extensions, luego **🚀 Start** de nuevo.
## Hoja vacía [#hoja-vacía]
**No email address found in your sheet**
MailG necesita al menos una columna con direcciones de correo válidas.
* Añada correos bajo un encabezado, o haga clic en **Fill with mock data**
* Los datos de prueba crean `Email`, `First Name`, `Last Name`, `Company` y a menudo **My First Template**
Consulte [Recorrido del diálogo de inicio](/getting-started/start-dialog).
## Plantillas [#plantillas]
* Crear: `Creating Template...` → `Template created successfully!` o `Failed to create template! Try again later.`
* Actualizar: `Updating template...`
* Fallos al eliminar: `Failed to delete template. Try again later`
Consulte [Plantillas](/features/templates).
## Problemas de envío [#problemas-de-envío]
### Botón de envío deshabilitado / Send emails sin conteo [#botón-de-envío-deshabilitado--send-emails-sin-conteo]
* Seleccione una **Template**
* Seleccione una **Recipient column** con correos **únicos** válidos por celda
* Toasts de bloqueo que puede ver: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### La campaña no arranca [#la-campaña-no-arranca]
Toast: `Failed to create campaign. Please try again.`
* Reintente una vez
* Compruebe que **Daily quota** no sea 0
* Confirme conectividad con la API (arriba)
### Filas muestran ⚠️ Failed [#filas-muestran-️-failed]
Esa fila tuvo un error de envío (dirección inválida, rechazo de Gmail, cuota transitoria, etc.). Corrija los datos e inicie una campaña nueva para filas restantes, o consulte [Detener una campaña](/features/stopping-a-campaign).
### Falla el correo de prueba [#falla-el-correo-de-prueba]
* `Configure your preview first` — elija plantilla + destinatario para que la vista previa tenga To
* `Failed to send test email. Please check your email settings.` — vuelva a autorizar Gmail si hace falta, luego reintente
## Seguimiento [#seguimiento]
* Las aperturas requieren que el destinatario cargue imágenes remotas
* Ejecute **🔄 Refresh Tracking** — espere `Tracking info synced` o `No active campaigns`
* El estado **👀 Opened** solo aparece cuando se carga el píxel
Consulte [Seguimiento de correos](/features/email-tracking).
## Cuota y branding [#cuota-y-branding]
* **N left** en la barra lateral es `min(MailG remaining, Gmail remaining)`
* `@gmail.com` gratuito suele limitarse cerca de 500/día por Google incluso en Professional
* Marca de agua tras pagar → el correo de pago debe coincidir con la cuenta de Sheets; vuelva a abrir el diálogo
Consulte [Cuota diaria y reseñas](/help/daily-quota-and-reviews) y [Quitar branding](/features/remove-branding).
## La programación no difirió [#la-programación-no-difirió]
Los horarios a menos de unos **15 segundos** se tratan como envío **inmediato** (columna 🚀), no como programación diferida 🗓️. Elija un horario más lejano.
## ¿Sigue atascado? [#sigue-atascado]
FAQ completa: [FAQ](/help/faq) · Correo [contact@mailg.io](mailto:contact@mailg.io) · Sitio [app.mailg.io/help](https://www.mailg.io/es/help)
# Cuota diaria y reseñas (/es/help/daily-quota-and-reviews)
La barra lateral principal muestra su capacidad de envío cuando se cargan los datos de cuenta.
## Bloque Daily quota [#bloque-daily-quota]
Interfaz exacta:
* Label: **Daily quota**
* Remaining: **N left**
* Plan line: **Your plan sends up to TOTAL/day**
**Remaining** es el mínimo de:
1. Restante del plan MailG para el día
2. Cuota de envío restante de Gmail para la cuenta
Así puede estar limitado por Gmail aunque MailG muestre margen en papel. Consulte también [Cuenta y facturación](/help/account-and-billing).
## CTAs del plan gratuito [#ctas-del-plan-gratuito]
Cuando no está suscrito, la barra lateral puede mostrar:
* **Leave a 5★ review for +N/day free** (bono predeterminado **+50/day** cuando la API no especifica otro valor)
* **Or upgrade your plan**
Al hacer clic en el CTA de reseña se abre **Free Quota upgrade**:
* Title: **Free Quota upgrade**
* Body: leave a 5-star review to get a free quota upgrade of **+N emails/day**
* Buttons: **Not now** | **Leave a 5★ review**
Si la URL de reseña no está configurada, **Leave a 5★ review** permanece deshabilitado — use **Upgrade to Pro** / pricing en su lugar.
## Mejorar a Pro [#mejorar-a-pro]
Botón del pie (cuentas gratuitas): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
Eso coincide con lo que desbloquean los planes de pago hoy en el producto.
## Relacionado [#relacionado]
* [Quitar branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Cuenta y facturación (/es/help/account-and-billing)
La facturación de MailG está vinculada al **correo de su cuenta de Google** en Sheets. Pague siempre con esa misma dirección para que las cuotas se desbloqueen en el complemento.
## Planes y cuotas diarias [#planes-y-cuotas-diarias]
| Plan | Daily quota | Notes |
| ------------ | ----------- | ------------------------------------- |
| Free | 50 | Core merge, open tracking, scheduling |
| Personal | 250 | Popular plan for growing lists |
| Professional | 1,500 | Highest recurring quota |
| Lifetime | 1,500 | One-time purchase |
Los precios e intervalos están en [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=es) (EUR y USD).
Los derechos de pago también desbloquean:
* [Send pacing](/features/send-pacing) distinto del predeterminado (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Su volumen de envío efectivo es `min(MailG daily quota, Gmail remaining quota)`.
## Cómo actualizar [#cómo-actualizar]
1. Abra [pricing](https://app.mailg.io/pricing?lang=es) (también enlazado desde el complemento vía **Upgrade to Pro**).
2. Elija un plan y complete Stripe Checkout con su correo de Google de Sheets.
3. Vuelva a abrir MailG en Sheets para que la actualización de cuenta recoja el nuevo límite.
## Cancelar o actualizar una suscripción [#cancelar-o-actualizar-una-suscripción]
Puede cancelar o cambiar su suscripción desde el portal de cliente de Stripe enlazado en su flujo de suscripción / precios.
* Si cancela a mitad de ciclo, las funciones Premium siguen activas hasta el final del periodo pagado
* No se le volverá a cobrar tras hacer efectiva la cancelación
## Reembolsos [#reembolsos]
Si cancela una suscripción Premium en **30 días** desde la compra, puede solicitar reembolso completo escribiendo a [contact@mailg.io](mailto:contact@mailg.io).
## Facturas [#facturas]
Stripe envía recibos por correo de pagos correctos. También puede descargar facturas desde el portal de cliente de Stripe usado para gestión de suscripción.
## Fragmentos de FAQ [#fragmentos-de-faq]
**¿MailG está incluido en Google Workspace?**\
No. MailG es independiente de Google. Una suscripción de Workspace no incluye MailG.
**¿Qué métodos de pago se aceptan?**\
Tarjetas principales, Google Pay y Apple Pay vía Stripe. PayPal no está admitido.
**Pagué pero sigo viendo el límite gratuito / marca de agua**\
Casi siempre es un desajuste de correo. Confirme correo de pago = correo de cuenta de Sheets, luego vuelva a abrir el complemento. Si persiste, contacte soporte con ambos correos.
**¿Por qué Gmail gratuito está limitado a unos 500 correos al día?**\
MailG Professional permite hasta 1.500 correos al día, pero Google limita las cuentas `@gmail.com` gratuitas a unos 500 envíos al día. Las cuentas de Google Workspace pueden ir más alto. Es un límite del proveedor Gmail, no de MailG.
# Programación de campañas (/es/features/campaign-scheduling)
Use **Schedule send** cuando quiera que MailG empiece más tarde. Disponible en planes gratuitos y de pago.
## Cómo programar [#cómo-programar]
1. Configure plantilla y destinatarios para que el botón de envío esté habilitado.
2. Abra el menú de envío (chevron) → **Schedule send**.
3. Dialog title: **Schedule send**
4. Description: `Pick date & time to schedule sending`
5. Summary line: scheduling N emails to be sent starting at the chosen date/time
6. Use the date picker plus **Hour** / **Minute** (placeholders `Hour`, `Min`).
7. Confirm with **Schedule Send** (or **Cancel**).
La sugerencia predeterminada es unos **60 minutos** adelante, redondeada al siguiente paso de **15 minutos**.
## Inmediato vs programado [#inmediato-vs-programado]
Los horarios a menos de unos **15 segundos** se tratan como envío **inmediato** (encabezado de columna 🚀), no como programación diferida 🗓️. Elija un horario más lejano si necesita envío diferido.
Toasts de validación: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Toast de éxito: campaña programada; N emails will start at the chosen time.
## Columna de la hoja [#columna-de-la-hoja]
Las campañas programadas crean un encabezado de columna como:
```text
🗓️ Template name (yyyy/MM/dd)
```
Los envíos inmediatos usan 🚀 en lugar de 🗓️.
Las filas empiezan como **🗓️ Scheduled**, luego pasan a **⏳ Sending…** cuando se ejecuta la cola.
## Después de programar [#después-de-programar]
* Mantenga la hoja accesible para la cuenta de Google que posee el complemento
* El seguimiento y el pacing siguen aplicándose cuando empiece el envío
* No hay interfaz **Manage Schedule** — consulte [Detener una campaña](/features/stopping-a-campaign)
## Relacionado [#relacionado]
* [Vista previa y prueba](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Varios destinatarios (/es/features/multiple-recipients)
Puede añadir destinatarios en copia por fila con columnas dedicadas en la hoja.
## Columna de destinatarios (Para) [#columna-de-destinatarios-para]
Seleccione **Recipient column** en la barra lateral.
Para el conteo del botón de envío y la validación de columna, MailG trata una celda como válida cuando es **una sola** dirección de correo. Prefiera una dirección To principal por fila.
## Columnas CC y BCC [#columnas-cc-y-bcc]
1. Añada columnas en la hoja (por ejemplo `CC` y `BCC`).
2. Ponga un correo (o lista aceptada por Gmail) en la celda.
3. Abra **More options** y asigne **CC** / **BCC**.
4. Al enviar, esos valores se pasan a Gmail.
El panel de vista previa muestra solo **From**, **To**, **Subject** y cuerpo. **No** muestra líneas CC/BCC aunque estén asignadas. Confirme con **Send me a test email** si necesita verificar la entrega CC/BCC.
## Cuotas: MailG vs Gmail [#cuotas-mailg-vs-gmail]
* La **cuota diaria de MailG** cuenta **filas de campaña** procesadas.
* Los **límites de envío de Gmail** cuentan **destinatarios** (direcciones To + CC + BCC que Gmail acepte en ese envío).
Puede alcanzar el límite de Gmail mientras la cuota de MailG sigue disponible.
## Consejos [#consejos]
* Prefiera **BCC** cuando los destinatarios no deban verse entre sí
* Deje CC/BCC sin asignar cuando no se usen
* Valide direcciones antes de un envío grande
# Attachments (/es/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Resumen de funciones (/es/features/features-overview)
Lo que el complemento admite hoy:
| Feature | Docs |
| ------------------------------------------- | ---------------------------------------------------------------- |
| Start dialog / empty sheet / mock data | [Recorrido del diálogo de inicio](/getting-started/start-dialog) |
| Templates (create / manage / edit / delete) | [Plantillas](/features/templates) |
| Merge tags in **body** | [Etiquetas de combinación](/features/merge-tags) |
| Rich-text toolbar | [Correos con texto enriquecido](/features/rich-text-emails) |
| Links (not image embeds) | [Imágenes](/features/images) |
| Preview + test email | [Vista previa y prueba](/features/preview-and-test) |
| Schedule send | [Programación de campañas](/features/campaign-scheduling) |
| Send pacing (paid) | [Send pacing](/features/send-pacing) |
| CC / BCC columns | [Varios destinatarios](/features/multiple-recipients) |
| Track emails | [Seguimiento de correos](/features/email-tracking) |
| Sender name & reply-to | [Remitente personalizado](/features/customized-sender) |
| Remove branding (paid) | [Quitar branding](/features/remove-branding) |
| Stop remaining rows | [Detener una campaña](/features/stopping-a-campaign) |
| Daily quota + review bonus | [Cuota diaria y reseñas](/help/daily-quota-and-reviews) |
## Gratis vs de pago [#gratis-vs-de-pago]
De pago desbloquea:
* [Send pacing](/features/send-pacing) distinto del predeterminado
* [Remove branding](/features/remove-branding)
* [Cuotas diarias](/help/account-and-billing) más altas
**Schedule send**, **Track emails** y las herramientas de plantillas funcionan sin actualización de pago.
## Limitaciones conocidas (con transparencia) [#limitaciones-conocidas-con-transparencia]
| Topic | Status in product |
| ----------------------- | ------------------------------- |
| Subject merge tags | Not applied at send — body only |
| Attachments column | UI only — not attached on send |
| Image embeds | No editor control — use links |
| Preview CC/BCC lines | Not shown in preview UI |
| Manage Schedule / Pause | Not shipped — status workaround |
## Próximamente [#próximamente]
Enlaces de baja, seguimiento de clics, asientos de equipo compartidos y una interfaz dedicada de gestión de campañas cuando estén disponibles.
# Seguimiento de correos (/es/features/email-tracking)
MailG puede registrar aperturas con un píxel invisible diminuto.
## Activar seguimiento [#activar-seguimiento]
En la barra lateral, deje **Track emails** activado (predeterminado activado para trabajos nuevos).
Tooltip: `Track emails opened with a tiny pixel`
El icono de ayuda abre **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Button: **Got it**
## Estados en la hoja [#estados-en-la-hoja]
| Status | Meaning |
| ------------- | ------------------------------- |
| 🗓️ Scheduled | Waiting for the scheduled start |
| ⏳ Sending… | Currently being processed |
| ✉️ Sent | Delivered to Gmail for that row |
| ⚠️ Failed | Send error for that row |
| 👀 Opened | Open pixel was loaded |
Los encabezados de columna de campaña se ven como `🚀 Template name (yyyy/MM/dd)` o `🗓️ …` cuando están programados.
## Actualizar seguimiento [#actualizar-seguimiento]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Alertas de Apps Script:
* `Tracking info synced`
* `No active campaigns`
## Limitaciones [#limitaciones]
* El cliente debe cargar imágenes remotas
* Los proxies de privacidad pueden ocultar aperturas
* Solo aperturas — no clics en enlaces
## Relacionado [#relacionado]
* [Programación de campañas](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Etiquetas de combinación (/es/features/merge-tags)
Las etiquetas de combinación permiten que cada destinatario reciba un **cuerpo** personalizado. Una etiqueta es el **encabezado de columna exacto** envuelto en llaves dobles.
## Sintaxis [#sintaxis]
Si su hoja tiene una columna llamada `First Name`, use:
```text
{{First Name}}
```
Ejemplo de cuerpo:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Dónde funcionan las etiquetas hoy [#dónde-funcionan-las-etiquetas-hoy]
| Field | Merged at send? |
| --------------- | -------------------------------------------------- |
| Email body | **Yes** — variables injected per row |
| Email subject | **No** — subject is sent as stored in the template |
| Preview body | **Yes** — for the active row |
| Preview subject | **No** — shows the raw template subject |
Ponga la personalización en el cuerpo hasta que el merge en el asunto esté disponible.
## Insertar etiquetas [#insertar-etiquetas]
En la barra de herramientas del editor, abra **Merge Tag**. Lista los encabezados de la hoja activa. Estado vacío: `No sheet columns found`.
El texto insertado usa llaves dobles alrededor del nombre de columna.
## Reglas prácticas [#reglas-prácticas]
* Los encabezados distinguen mayúsculas y minúsculas (`Name` ≠ `name`)
* Las celdas vacías se insertan como cadenas vacías
* Puede reutilizar la misma etiqueta varias veces en el cuerpo
* Destinatario / CC / BCC se eligen bajo **More options**, no mediante etiquetas de combinación
## Siguiente [#siguiente]
Consulte [Correos con texto enriquecido](/features/rich-text-emails) y [Vista previa y prueba](/features/preview-and-test).
# Correos con texto enriquecido (/es/features/rich-text-emails)
Las plantillas de MailG usan un editor de texto enriquecido TipTap. El HTML que produce es lo que Gmail entrega.
Marcador de posición del cuerpo: `Write your email…`
## Inventario de la barra de herramientas (interfaz exacta) [#inventario-de-la-barra-de-herramientas-interfaz-exacta]
| Group | Controls |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (presets in the toolbar) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | Preset swatches + native color picker + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — URL field placeholder `https://example.com`, then **Apply** (and unlink) |
| History | **Undo**, **Redo** |
## No está en el editor [#no-está-en-el-editor]
Estas funciones de TipTap están desactivadas / ausentes:
* Headings, code, code block, blockquote, horizontal rule
* Image insert / Drive media picker — consulte [Imágenes](/features/images)
## Hipervínculos [#hipervínculos]
Use **Insert link** para la URL y el texto visible. Prefiera texto de enlace claro frente a URLs sin formato.
## Consejos [#consejos]
* Use **Merge Tag** en lugar de escribir llaves a mano
* Previsualice varias filas antes de enviar — consulte [Vista previa y prueba](/features/preview-and-test)
* Evite pegar markup enorme de Word/Docs; vuelva a aplicar formato en MailG para HTML más limpio
# Quitar branding de MailG (/es/features/remove-branding)
Las campañas gratuitas pueden incluir una pequeña marca de agua de MailG en el pie del correo. Los suscriptores de pago pueden desactivarla.
## Cómo quitar el branding [#cómo-quitar-el-branding]
1. Confirme que tiene un plan de pago activo (Personal, Professional o Lifetime).
2. Abra la barra lateral de campaña.
3. Active **Remove branding**.
4. Previsualice una fila para confirmar que desapareció la marca de agua, luego envíe.
Si el branding sigue apareciendo tras pagar:
* Asegúrese de que el pago usó el **mismo correo** que su cuenta de Google Sheets
* Vuelva a abrir el complemento para refrescar derechos desde la API
* Contacte con [contact@mailg.io](mailto:contact@mailg.io) con su correo de cuenta de Google
Consulte [Cuenta y facturación](/help/account-and-billing).
# Imágenes (/es/features/images)
El editor de MailG **no tiene botón de insertar imagen** ni selector de medios de Google Drive. La extensión Image de TipTap no está activada.
## Qué puede hacer hoy [#qué-puede-hacer-hoy]
Use **Insert link** en la barra de herramientas:
1. Aloje la imagen (o archivo) en una URL pública, o comparta un enlace de Drive.
2. Seleccione texto (o coloque el cursor) → **Insert link**.
3. Pegue la URL (placeholder `https://example.com`) → **Apply**.
Los destinatarios abren el enlace para ver la imagen o archivo. El editor no incrusta etiquetas `![]()
` por usted.
## Consejos [#consejos]
* Prefiera archivos pequeños y texto de enlace claro («View screenshot»)
* Los enlaces que requieren inicio de sesión fallarán para los destinatarios
* Confirme con **Send me a test email**
## Próximamente [#próximamente]
Puede llegar más adelante una incrustación de imagen de primera clase / selector de Drive. Hasta entonces, los hipervínculos son la vía admitida.
# Plantillas (/es/features/templates)
Las plantillas almacenan el asunto y el cuerpo enriquecido que reutiliza en campañas. Se guardan en la API de MailG para su cuenta de Google.
## Crear una plantilla [#crear-una-plantilla]
1. En la pantalla principal, haga clic en **New Template**.
2. Complete:
* **Template Name**
* **Email Subject**
* Cuerpo (editor enriquecido — consulte [Correos con texto enriquecido](/features/rich-text-emails))
3. Haga clic en **Save Template** (muestra **Saving...** mientras trabaja).
Toasts:
* Loading: `Creating Template...`
* Success: `Template created successfully!`
* Error: `Failed to create template! Try again later.`
Plantilla de demostración de **Fill with mock data**: nombre **My First Template**, asunto `I found a mail merge tool for Gmail`.
## Gestionar plantillas [#gestionar-plantillas]
Abra el icono de plantilla junto al selector de plantilla (tooltip **Manage templates**).
Columnas de la tabla:
| Column | Content |
| ----------------- | ------------- |
| **Name** | Template name |
| **Email Subject** | Subject line |
| **Created At** | Creation date |
| **Actions** | Row menu |
Menú de fila: **Edit** | **Delete**
Pie: **Back**
Toasts de eliminación: deleting template NAME → template NAME deleted successfully (o un mensaje de error).
## Editar una plantilla [#editar-una-plantilla]
Abra **Edit** desde gestión, o haga clic en **Edit template** en la barra de herramientas de vista previa.
Mismos campos que al crear. **Save Template** actualiza la plantilla.
El flujo de actualización muestra un toast de carga (`Updating template...`). Permanezca en el formulario hasta que termine, luego use **Cancel** o **Back** si no vuelve automáticamente.
## Asunto vs cuerpo [#asunto-vs-cuerpo]
* El **cuerpo** admite [etiquetas de combinación](/features/merge-tags) — se inyectan por fila al enviar.
* **Email Subject** se envía tal como está guardado hoy (las etiquetas de combinación en el asunto **no** se sustituyen aún). Ponga la personalización en el cuerpo o use un asunto fijo.
## Relacionado [#relacionado]
* [Vista previa y prueba](/features/preview-and-test)
* [Recorrido del diálogo de inicio](/getting-started/start-dialog)
# Vista previa y prueba (/es/features/preview-and-test)
El panel de vista previa (lado derecho del diálogo principal) muestra cómo se ve un mensaje para la fila activa de la hoja.
## Qué muestra la vista previa [#qué-muestra-la-vista-previa]
| Field | Content |
| ------------ | -------------------------------------------------------------------------------------- |
| **From:** | Your signed-in Google account email |
| **To:** | Value from the **Recipient column** for the active row, or `Select a recipient column` |
| **Subject:** | Template subject as stored (not merge-substituted) |
| Body | Template body with merge tags applied for that row |
Si **Remove branding** está desactivado, la vista previa incluye el pie de marca de agua de MailG (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## Qué no se muestra [#qué-no-se-muestra]
* Las filas **CC** / **BCC** no se renderizan en la interfaz de vista previa (aunque estén asignadas bajo **More options**). Sí se aplican al enviar.
* Los valores de la columna de adjuntos no aparecen en la vista previa.
## Navegar filas [#navegar-filas]
Barra de herramientas de vista previa:
* **Edit template** — abre la pantalla de actualización de plantilla
* **Previous recipient** / **Next recipient** — moverse entre filas de datos (los tooltips pueden incluir el número de fila; el encabezado es la fila 1, el primer contacto es la fila 2)
## Enviarme un correo de prueba [#enviarme-un-correo-de-prueba]
1. Configure plantilla + columna de destinatario para que la vista previa sea válida.
2. Abra el menú de envío (chevron) → **Send me a test email**.
3. Superposición de carga: `Sending test email…`
4. Toast de éxito: `Test email sent successfully. Check your inbox.`
5. Toast de error: `Failed to send test email. Please check your email settings.`
6. Bloqueo si la vista previa está incompleta: `Configure your preview first`
La prueba va a la bandeja de **su** cuenta de Google, usando el cuerpo combinado de la fila activa en vista previa.
## Consejos [#consejos]
* Recorra varias filas con las flechas antes de un envío completo
* Confirme branding / sin branding en la vista previa
* Pruebe siempre antes de **Schedule send** o un **Send N email(s)** grande
## Relacionado [#relacionado]
* [Etiquetas de combinación](/features/merge-tags)
* [Tutorial de mail merge](/getting-started/mail-merge-tutorial)
# Ritmo de envío (/es/features/send-pacing)
Send pacing añade retraso entre mensajes para que una campaña grande no salga de su cuenta como un único estallido.
**Steady pace** y **Jittered gaps** requieren una suscripción de pago activa de MailG. Las cuentas gratuitas solo usan **Burst send**.
## Dónde configurarlo [#dónde-configurarlo]
Abra el engranaje del pie (tooltip **Send pacing**). Screen heading: **Send pacing**.
Bajo **Dispatch mode**, elija cómo se espacian los correos. **Gap between emails** se configura en **seconds** (0–60). Las cuentas gratuitas ven **Pro features** y el texto bloqueado: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Predeterminado para trabajos nuevos: **Burst send**, gap **10s** (el gap se ignora hasta salir de burst).
## Modos [#modos]
| Mode (UI label) | Behavior |
| ------------------------ | ----------------------------------------------- |
| **Burst send** (default) | Send as quickly as quotas allow |
| **Steady pace** | Wait a fixed gap between each email |
| **Jittered gaps** | Wait a random gap between 0 and your chosen max |
## Por qué usar pacing [#por-qué-usar-pacing]
* Reducir la probabilidad de parecer un envío súbito para los proveedores de correo
* Repartir una lista larga en una ventana de envío más tranquila
* Mantenerse dentro de los márgenes de comodidad de Gmail para su tipo de cuenta
## Notas [#notas]
* El pacing es un ajuste de campaña guardado con el trabajo — los envíos nuevos usan la configuración actual
* Un gap largo en una lista grande aumenta mucho la duración total de la campaña
* Su velocidad efectiva sigue limitada por la cuota diaria de MailG **y** la cuota restante de envío de Gmail
* Algunas herramientas competidoras expresan el retraso en minutos — MailG usa **seconds**
## Relacionado [#relacionado]
* [Detener una campaña](/features/stopping-a-campaign) si configuró un gap demasiado alto a mitad de ejecución
* [Cuenta y facturación](/help/account-and-billing)
# Detener una campaña (/es/features/stopping-a-campaign)
MailG aún no incluye una pantalla dedicada **Manage Schedule**, **Abort** o **Pause** como algunos competidores. Aun así puede detener filas **restantes** para que no se envíen.
## Cómo decide el envío qué procesar [#cómo-decide-el-envío-qué-procesar]
El bucle de envío solo procesa filas cuyo estado en la columna de campaña sigue siendo enviable:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
Las filas ya marcadas **✉️ Sent**, **⚠️ Failed** o **👀 Opened** se omiten.
## Detener filas restantes (solución honesta) [#detener-filas-restantes-solución-honesta]
Actúe rápido en una campaña grande:
1. Abra la hoja de cálculo.
2. En la columna de estado de campaña, borre o cambie el estado en filas que **no** deban enviarse (por ejemplo elimine el valor de celda, o ponga una etiqueta no enviable como `Stopped`).
3. Deje intactas las filas ya **✉️ Sent** — esos mensajes ya salieron.
Las filas que borre/cambie ya no coincidirán con estados enviables, así que la cola las omitirá en la siguiente pasada.
Los mensajes de Gmail que ya salieron de la cuenta no pueden deshacerse con MailG. Detener solo protege filas que aún no se procesaron.
## Campañas programadas que no han empezado [#campañas-programadas-que-no-han-empezado]
Si cada fila sigue **🗓️ Scheduled** y la hora de inicio no ha llegado, borrar esos estados (o la columna de campaña) evita que la cola las tome cuando llegue la hora.
Si tiene dudas, contacte con [contact@mailg.io](mailto:contact@mailg.io) con la URL de la hoja y detalles de la campaña.
## Relacionado [#relacionado]
* [Programación de campañas](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Remitente personalizado (/es/features/customized-sender)
Por defecto, Gmail envía desde la cuenta de Google que autorizó MailG. Aun así puede personalizar cómo aparece su nombre y adónde van las respuestas.
## Nombre del remitente [#nombre-del-remitente]
1. Abra **More options** en la barra lateral de campaña.
2. Configure **Sender name** (placeholder `John Doe (Optional)`).
3. Los destinatarios ven ese nombre en su bandeja (sujeto a las reglas habituales de presentación de Gmail).
## Dirección de respuesta [#dirección-de-respuesta]
Configure **Reply to address** (placeholder `john@doe.com (Optional)`) si las respuestas deben ir a otro sitio distinto de la cuenta de envío.
## Notas [#notas]
* La dirección From subyacente sigue siendo la cuenta de Gmail autorizada — no puede suplantar otro buzón
* Direcciones reply-to inválidas pueden causar problemas de entrega o respuesta — use un buzón que controle
* La vista previa muestra **From:** como su correo iniciado; confirme reply-to con **Send me a test email**
* Consulte [Vista previa y prueba](/features/preview-and-test)
# Recorrido del diálogo de inicio (/es/getting-started/start-dialog)
Abra el complemento con **Extensions → MailG for Gmail → 🚀 Start**. Se abre un diálogo de 900×600 titulado **MailG for Gmail**.
## Pantallas [#pantallas]
| Screen | How you get there | Purpose |
| ------------------ | -------------------------------------------- | ----------------------------------------- |
| Root (composer) | Default after load | Pick template + recipients, preview, send |
| Create template | **New Template** | Name, subject, body |
| Manage templates | Template icon (tooltip **Manage templates**) | List, edit, delete |
| Update template | **Edit template** or row **Edit** | Edit an existing template |
| Settings | Footer gear (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | No valid email column | Prompt to add contacts or mock data |
| API / sheet errors | Load failure | Retry guidance |
## Diseño principal [#diseño-principal]
Tres zonas:
1. **Sidebar** (izquierda) — plantilla, columna de destinatario, **More options**, seguimiento, branding, cuota
2. **Preview** (derecha) — From / To / Subject / cuerpo, navegación por filas, **Edit template**
3. **Footer** — botón de envío, menú de envío, **Upgrade to Pro** (gratis), ajustes, ayuda
## Controles de la barra lateral (etiquetas exactas) [#controles-de-la-barra-lateral-etiquetas-exactas]
* **New Template**
* **Template** (select) — placeholder `Select` or `No templates found`
* **Recipient column** — opciones como `A - Email`; vacío: `No valid email columns found.`
* **More options** — expande **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (activado por defecto)
* **Remove branding** (de pago)
* **Daily quota** — restante como «N left» y línea de plan «Your plan sends up to TOTAL/day»
Las cuentas gratuitas también ven **Leave a 5★ review for +N/day free** y **Or upgrade your plan**. Consulte [Cuota diaria y reseñas](/help/daily-quota-and-reviews).
## Controles de envío del pie [#controles-de-envío-del-pie]
| Control | Label |
| -------------- | ------------------------------------------------------------------------------------- |
| Primary button | **Send N email(s)** (or **Send emails** when count is 0) |
| Send menu | **Send me a test email** |
| Send menu | **Schedule send** |
| Upgrade (free) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Gear | tooltip **Send pacing** |
| Help | tooltip **Help** — opens the in-dialog checklist |
### Lista Need help? [#lista-need-help]
1. Pick a template and recipient column
2. Preview each row with the arrows
3. Send a test email to yourself first
4. Click Send to merge from your sheet
Buttons: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (if available) | **Close**
## Hoja vacía [#hoja-vacía]
Si MailG no encuentra una columna de correo válida:
* Title: **No email address found in your sheet**
* Actions: **Close** | **Fill with mock data**
Los datos de prueba crean encabezados `Email`, `First Name`, `Last Name`, `Company` y pueden crear **My First Template**.
## Pantallas de error [#pantallas-de-error]
| Title | When |
| --------------------------------- | --------------------- |
| **Could not reach the MailG API** | API / network failure |
| **Could not read your sheet** | Sheet read failure |
## Siguiente [#siguiente]
# Instalación (/es/getting-started/installation)
Dos pasos: instalar el complemento y luego abrirlo desde Sheets.
## Instalar MailG [#instalar-mailg]
1. Abra el [listado de MailG en Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Haga clic en **Install**.
3. Elija la cuenta de Google que debe poseer la instalación.
4. Revise los permisos y haga clic en **Allow**.
La instalación suele terminar en menos de 15 segundos. Debería ver una confirmación de que el complemento se instaló.
Si el listado de Marketplace aún no está disponible en su región, use el CTA de instalación en [www.mailg.io](https://www.mailg.io) o contacte con [contact@mailg.io](mailto:contact@mailg.io).
## Abrir MailG en Google Sheets [#abrir-mailg-en-google-sheets]
1. Abra [Google Sheets](https://sheets.google.com) (actualice si Sheets ya estaba abierto).
2. Espere unos segundos a que se carguen Extensions (a menudo \~10–15 segundos).
3. Vaya a **Extensions → MailG for Gmail → 🚀 Start**.
Más adelante puede ejecutar **Extensions → MailG for Gmail → 🔄 Refresh Tracking** para sincronizar estados de apertura sin abrir el diálogo completo.
## Problemas de instalación [#problemas-de-instalación]
Son peculiaridades habituales de Google Workspace, no errores de MailG:
### Nunca veo la ventana emergente de «instalado correctamente» [#nunca-veo-la-ventana-emergente-de-instalado-correctamente]
Esto suele ocurrir cuando hay varias cuentas de Google iniciadas y la instalación no usó la cuenta que esperaba.
**Solución:** abra una ventana privada/incógnito, inicie sesión solo con la cuenta objetivo e instale de nuevo desde Marketplace.
### MailG no aparece en Extensions [#mailg-no-aparece-en-extensions]
1. Actualice la hoja de cálculo.
2. Espere unos 10–15 segundos a que se carguen los complementos.
3. Confirme que está en la misma cuenta de Google que instaló MailG.
4. Pruebe otra hoja o borre la caché del navegador si sigue sin aparecer.
## Implementaciones autohospedadas / personalizadas [#implementaciones-autohospedadas--personalizadas]
Las instalaciones de Marketplace vienen preconfiguradas. Si implementa MailG usted mismo, configure las propiedades del script de Apps Script:
| Property | Value |
| ------------- | ---------------------------------------- |
| `APP_URL` | URL HTTPS pública de su API de MailG |
| `APP_API_KEY` | La misma clave que el servidor de la API |
El complemento no puede alcanzar `localhost` desde los servidores de Google — use un túnel (Cloudflare Tunnel, ngrok, etc.) para pruebas locales.
## Siguiente [#siguiente]
Continúe con el [tutorial de mail merge](/getting-started/mail-merge-tutorial).
# Tutorial de mail merge (/es/getting-started/mail-merge-tutorial)
Este recorrido coincide con el diálogo de inicio **MailG for Gmail**.
## 1. Abrir MailG [#1-abrir-mailg]
**Extensions → MailG for Gmail → 🚀 Start**.
Si ve **No email address found in your sheet**, añada correos reales o haga clic en **Fill with mock data** (crea filas de ejemplo y a menudo **My First Template**). Consulte [Recorrido del diálogo de inicio](/getting-started/start-dialog).
## 2. Crear o seleccionar una plantilla [#2-crear-o-seleccionar-una-plantilla]
1. Haga clic en **New Template** (o elija una existente bajo **Template**).
2. Configure **Template Name** y **Email Subject** (el asunto **no** se sustituye con merge hoy).
3. Escriba el cuerpo e inserte [etiquetas de combinación](/features/merge-tags) con **Merge Tag**.
4. **Save Template**.
Ejemplo de cuerpo:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Configurar la campaña [#3-configurar-la-campaña]
En la barra lateral:
1. Elija **Recipient column** (las celdas deben ser correos únicos válidos para que la interfaz los cuente).
2. Abra **More options** para **CC**, **BCC**, **Sender name**, **Reply to address**.
3. Deje **Track emails** activado (predeterminado) si quiere el estado de apertura en la hoja.
4. En un plan de pago, active **Remove branding**.
**Attachments** aparece bajo **More options**, pero los archivos aún no se adjuntan al enviar. En su lugar, enlace a Drive o a una URL en el cuerpo.
## 4. Vista previa y prueba [#4-vista-previa-y-prueba]
1. Use las flechas anterior/siguiente para recorrer filas.
2. Confirme **To:** y el cuerpo combinado (el asunto muestra el asunto sin procesar de la plantilla).
3. Menú de envío → **Send me a test email**.
4. Revise su bandeja de entrada.
Detalles: [Vista previa y prueba](/features/preview-and-test).
## 5. Enviar o programar [#5-enviar-o-programar]
* Botón principal: **Send N email(s)** cuando hay destinatarios contados.
* O menú de envío → **Schedule send** → elija fecha/hora → **Schedule Send**.
Superposiciones de carga: `Starting your campaign…` / toasts de confirmación de programación.
MailG añade una columna de campaña como `🚀 My Template (yyyy/MM/dd)` o `🗓️ …` cuando está programada.
Estados de fila:
| Status | Meaning |
| ------------- | ----------------- |
| 🗓️ Scheduled | Waiting for start |
| ⏳ Sending… | Processing |
| ✉️ Sent | Handed to Gmail |
| ⚠️ Failed | Error |
| 👀 Opened | Open pixel loaded |
## Errores habituales [#errores-habituales]
* Etiquetas en el asunto esperando personalización — solo el cuerpo por ahora
* Celdas de destinatario con varias direcciones separadas por comas — la interfaz valida **one** email por celda para el conteo
* Cuenta de Google incorrecta frente a la cuenta de instalación
* Agotar la cuota diaria — consulte **Daily quota** en la barra lateral
## Consejos [#consejos]
* Use la lista **Help** del pie la primera vez
* Empiece con 2–3 filas reales tras los datos de prueba
* Tras aperturas: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alerta `Tracking info synced` (o `No active campaigns`)
## Siguiente [#siguiente]
# ¿Qué es MailG? (/es/getting-started/what-is-mailg)
MailG convierte una hoja de Google Sheets en una campaña de mail merge. Cada fila es un destinatario; los encabezados de columna se convierten en etiquetas de combinación (llaves dobles alrededor del nombre del encabezado) en el **cuerpo del correo**.
## Qué puede hacer [#qué-puede-hacer]
* Crear plantillas en la nube (**Template Name**, **Email Subject**, cuerpo enriquecido)
* Personalizar el **cuerpo** con etiquetas de combinación a partir de los encabezados de la hoja
* Previsualizar filas y **Send me a test email**
* Asignar **CC** / **BCC**, **Sender name**, **Reply to address**
* **Schedule send** o enviar de inmediato
* **Track emails** con chips de estado de apertura en la hoja
* Controlar **Send pacing** en planes de pago
* **Remove branding** en planes de pago
* Consultar **Daily quota** (y opcionalmente reclamar un bono gratuito por reseña)
## Cómo encaja todo [#cómo-encaja-todo]
1. **Complemento de Google Sheets** — diálogo bajo **MailG for Gmail**
2. **API de MailG** — plantillas, metadatos de campaña, seguimiento de aperturas y derechos
3. **Su Gmail** — mensajes enviados con `GmailApp` desde la cuenta autorizada
## Próximos pasos [#próximos-pasos]
# Связаться с нами (/ru/contact-us)
## Оплата и подписки [#оплата-и-подписки]
Большинство изменений подписки можно выполнить через портал Stripe по ссылке с [pricing](https://app.mailg.io/pricing?lang=ru). По возвратам и проблемам с оплатой напишите нам.
## Всё остальное [#всё-остальное]
Напишите на **[contact@mailg.io](mailto:contact@mailg.io)**.
Обычно мы отвечаем в течение одного рабочего дня.
## Полезные ссылки [#полезные-ссылки]
* [Сайт](https://www.mailg.io)
* [Цены](https://app.mailg.io/pricing?lang=ru)
* [Конфиденциальность](https://www.mailg.io/ru/privacy)
* [Условия](https://www.mailg.io/ru/terms)
* [Главная документации](/)
# Документация MailG (/ru)
MailG — надстройка Google Sheets для mail merge с Gmail. Откройте **Extensions → MailG for Gmail → 🚀 Start**, создайте шаблон, просмотрите строки, затем отправьте или запланируйте с вашего аккаунта Gmail.
## Начните здесь [#начните-здесь]
## Популярные темы [#популярные-темы]
## Полезные ссылки [#полезные-ссылки]
* Сайт: [www.mailg.io](https://www.mailg.io)
* Документация: [docs.mailg.io/ru](https://docs.mailg.io/ru)
* Цены: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=ru)
* Контакт: [contact@mailg.io](mailto:contact@mailg.io)
## Для ИИ-ассистентов / LLM [#для-ии-ассистентов--llm]
Предпочитайте эти машиночитаемые эндпоинты вместо парсинга HTML:
* [Agents hub](https://www.mailg.io/ru/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/ru/help/faq)
## Установка и запуск [#установка-и-запуск]
**Как открыть MailG?**\
**Extensions → MailG for Gmail → 🚀 Start**. См. [Установка](/getting-started/installation).
**No email address found in your sheet**\
Добавьте email в столбец или **Fill with mock data**. См. [Обзор диалога запуска](/getting-started/start-dialog).
**Could not reach the MailG API**\
Сеть / URL API (self-hosted: `APP_URL` + `APP_API_KEY`). Переоткройте диалог после исправления.
## Отправка [#отправка]
**Письма не отправляются**\
**Daily quota**, разрешения Gmail, валидные одиночные email в **Recipient column**. Ошибки — **⚠️ Failed**.
**Работают ли merge tags в теме?**\
Пока нет. Объединяется только **тело**. Фиксированная тема или персонализация в теле. См. [Теги слияния](/features/merge-tags).
**Можно прикрепить файлы?**\
**Attachments** в **More options** есть, но при отправке файлы не прикрепляются. Используйте ссылки.
**Как остановить кампанию?**\
[Остановка кампании](/features/stopping-a-campaign) — очистите отправляемые статусы на оставшихся строках.
**Почему лимит на Professional?**\
MailG до 1 500/день, но free `@gmail.com` часто \~500 от Google.
## Отслеживание [#отслеживание]
**В листе Sent после открытия**\
**🔄 Refresh Tracking** → `Tracking info synced`. Некоторые клиенты не грузят изображения.
**Клики?**\
Не отслеживаются. **Track emails** = только открытия.
## Квота и оплата [#квота-и-оплата]
См. [Дневная квота и отзывы](/help/daily-quota-and-reviews) и [Аккаунт и оплата](/help/account-and-billing).
**Schedule send платный?**\
Нет. Paid — выше квоты, pacing, **Remove branding**.
## Устранение неполадок [#устранение-неполадок]
Пошагово: [Устранение неполадок](/help/troubleshooting).
Частые toasts:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Всё ещё проблема? [#всё-ещё-проблема]
[Устранение неполадок](/help/troubleshooting) · Docs [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Устранение неполадок (/ru/help/troubleshooting)
Быстрые решения для сообщений и состояний в надстройке.
## Диалог не загружается [#диалог-не-загружается]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
Диалог не смог вызвать backend MailG.
* Проверьте сеть
* Marketplace: подождите и переоткройте **🚀 Start**
* Self-hosted: `APP_URL` (публичный HTTPS) и `APP_API_KEY`
* `localhost` недоступен — туннель для локального API
### Could not read your sheet [#could-not-read-your-sheet]
MailG не прочитал активную таблицу.
* Открыта вкладка листа (не только редактор Apps Script)
* Перезагрузите таблицу и диалог
* Права редактирования файла
### Loading… never finishes [#loading-never-finishes]
Закройте диалог, обновите Sheets, \~15 секунд Extensions, снова **🚀 Start**.
## Пустой лист [#пустой-лист]
**No email address found in your sheet**
Нужен хотя бы один столбец с валидными email.
* Email под заголовком или **Fill with mock data**
* Mock: `Email`, `First Name`, `Last Name`, `Company` и часто **My First Template**
См. [Обзор диалога запуска](/getting-started/start-dialog).
## Шаблоны [#шаблоны]
* Создание: `Creating Template...` → `Template created successfully!` или `Failed to create template! Try again later.`
* Обновление: `Updating template...`
* Удаление: `Failed to delete template. Try again later`
См. [Шаблоны](/features/templates).
## Проблемы отправки [#проблемы-отправки]
### Кнопка отправки неактивна / Send emails без счёта [#кнопка-отправки-неактивна--send-emails-без-счёта]
* **Template**
* **Recipient column** с **одним** валидным email на ячейку
* Toasts: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### Кампания не стартует [#кампания-не-стартует]
Toast: `Failed to create campaign. Please try again.`
* Повторите
* **Daily quota** не 0
* Связь с API
### Строки ⚠️ Failed [#строки-️-failed]
Ошибка отправки строки. Исправьте данные, новая кампания для остатка или [Остановка кампании](/features/stopping-a-campaign).
### Тест не отправился [#тест-не-отправился]
* `Configure your preview first`
* `Failed to send test email. Please check your email settings.` — переавторизуйте Gmail
## Отслеживание [#отслеживание]
* Открытия требуют загрузки удалённых изображений
* **🔄 Refresh Tracking** — `Tracking info synced` или `No active campaigns`
* **👀 Opened** только при загрузке пикселя
См. [Отслеживание писем](/features/email-tracking).
## Квота и брендинг [#квота-и-брендинг]
* **N left** = `min(MailG remaining, Gmail remaining)`
* Free `@gmail.com` \~500/день от Google даже на Professional
* Водяной знак после оплаты → email checkout = Sheets; переоткройте диалог
См. [Дневная квота и отзывы](/help/daily-quota-and-reviews) и [Удаление брендинга](/features/remove-branding).
## Планирование не отложилось [#планирование-не-отложилось]
Менее \~**15 секунд** — немедленная отправка (🚀), не 🗓️. Выберите время дальше.
## Всё ещё проблема? [#всё-ещё-проблема]
FAQ: [FAQ](/help/faq) · [contact@mailg.io](mailto:contact@mailg.io) · [app.mailg.io/help](https://www.mailg.io/ru/help)
# Дневная квота и отзывы (/ru/help/daily-quota-and-reviews)
На главной боковой панели — ёмкость отправки при загруженных данных аккаунта.
## Блок Daily quota [#блок-daily-quota]
Точный UI:
* Label: **Daily quota**
* Remaining: **N left**
* Plan line: **Your plan sends up to TOTAL/day**
**Remaining** — минимум из:
1. Остаток плана MailG на день
2. Остаток отправки Gmail для аккаунта
Можно упираться в Gmail при запасе MailG на бумаге. См. [Аккаунт и оплата](/help/account-and-billing).
## CTA free плана [#cta-free-плана]
Без подписки на боковой панели:
* **Leave a 5★ review for +N/day free** (по умолчанию **+50/day**, если API не указал иное)
* **Or upgrade your plan**
Клик по отзыву — **Free Quota upgrade**:
* Title: **Free Quota upgrade**
* Body: leave a 5-star review to get a free quota upgrade of **+N emails/day**
* Buttons: **Not now** | **Leave a 5★ review**
Без URL отзыва **Leave a 5★ review** disabled — **Upgrade to Pro** / pricing.
## Перейти на Pro [#перейти-на-pro]
Кнопка футера (free): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
Соответствует paid планам сегодня.
## Связанное [#связанное]
* [Удаление брендинга](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Аккаунт и оплата (/ru/help/account-and-billing)
Оплата MailG привязана к **email Google-аккаунта** в Sheets. Оплачивайте тем же адресом, чтобы квоты открылись в надстройке.
## Планы и дневные квоты [#планы-и-дневные-квоты]
| Plan | Daily quota | Notes |
| ------------ | ----------- | ------------------------------------- |
| Free | 50 | Core merge, open tracking, scheduling |
| Personal | 250 | Popular plan for growing lists |
| Professional | 1,500 | Highest recurring quota |
| Lifetime | 1,500 | One-time purchase |
Цены на [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=ru) (EUR и USD).
Paid также открывает:
* Нестандартный [send pacing](/features/send-pacing) (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Эффективный объём: `min(MailG daily quota, Gmail remaining quota)`.
## Как обновить план [#как-обновить-план]
1. [pricing](https://app.mailg.io/pricing?lang=ru) (или **Upgrade to Pro** в надстройке).
2. План и Stripe Checkout с email Google Sheets.
3. Переоткройте MailG для нового лимита.
## Отмена или изменение подписки [#отмена-или-изменение-подписки]
Портал Stripe из потока подписки / pricing.
* Отмена mid-cycle — Premium до конца оплаченного периода
* После отмены повторных списаний нет
## Возвраты [#возвраты]
Отмена Premium в **30 дней** — полный возврат на [contact@mailg.io](mailto:contact@mailg.io).
## Счета [#счета]
Stripe шлёт квитанции. Счета также в портале Stripe.
## FAQ [#faq]
**MailG входит в Google Workspace?**\
Нет. MailG независим от Google. Workspace не включает MailG.
**Способы оплаты?**\
Карты, Google Pay, Apple Pay через Stripe. PayPal не поддерживается.
**Оплатил, но free лимит / водяной знак**\
Обычно несовпадение email. Checkout = Sheets, переоткройте надстройку. Иначе support с обоими email.
**Почему free Gmail \~500 писем/день?**\
Professional до 1 500/день, но Google ограничивает free `@gmail.com` \~500. Workspace выше. Лимит Gmail, не MailG.
# Планирование кампаний (/ru/features/campaign-scheduling)
Используйте **Schedule send**, когда MailG должен стартовать позже. Доступно на free и paid планах.
## Как запланировать [#как-запланировать]
1. Настройте шаблон и получателей, чтобы кнопка отправки была активна.
2. Меню отправки (chevron) → **Schedule send**.
3. Dialog title: **Schedule send**
4. Description: `Pick date & time to schedule sending`
5. Summary line: scheduling N emails to be sent starting at the chosen date/time
6. Date picker плюс **Hour** / **Minute** (placeholders `Hour`, `Min`).
7. Подтвердите **Schedule Send** (или **Cancel**).
По умолчанию \~**60 минут** вперёд, округление к **15 минутам**.
## Сразу vs по расписанию [#сразу-vs-по-расписанию]
Менее \~**15 секунд** вперёд — **немедленная** отправка (столбец 🚀), не отложенная 🗓️. Выберите время дальше для отложенной отправки.
Toasts: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Успех: кампания запланирована; N emails will start at the chosen time.
## Столбец листа [#столбец-листа]
Запланированные кампании создают заголовок:
```text
🗓️ Template name (yyyy/MM/dd)
```
Немедленные — 🚀 вместо 🗓️.
Строки начинаются как **🗓️ Scheduled**, затем **⏳ Sending…** при запуске очереди.
## После планирования [#после-планирования]
* Лист должен быть доступен аккаунту Google с надстройкой
* Отслеживание и pacing применяются после старта отправки
* Нет UI **Manage Schedule** — см. [Остановка кампании](/features/stopping-a-campaign)
## Связанное [#связанное]
* [Предпросмотр и тест](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Несколько получателей (/ru/features/multiple-recipients)
Можно добавить копии получателям по строкам через отдельные столбцы листа.
## Столбец получателей (Кому) [#столбец-получателей-кому]
Выберите **Recipient column** на боковой панели.
Для подсчёта кнопки и валидации MailG считает ячейку валидной при **одном** email. Один основной To на строку.
## Столбцы CC и BCC [#столбцы-cc-и-bcc]
1. Добавьте столбцы (например `CC` и `BCC`).
2. Email (или список, принимаемый Gmail) в ячейке.
3. **More options** → **CC** / **BCC**.
4. При отправке значения передаются в Gmail.
Предпросмотр показывает только **From**, **To**, **Subject** и тело. CC/BCC **не** отображаются. Проверьте **Send me a test email** для CC/BCC.
## Квоты: MailG vs Gmail [#квоты-mailg-vs-gmail]
* **Дневная квота MailG** — **строки кампании**.
* **Лимиты Gmail** — **получатели** (To + CC + BCC, принятые Gmail).
Можно упереться в лимит Gmail при остатке квоты MailG.
## Советы [#советы]
* **BCC**, если получатели не должны видеть друг друга
* CC/BCC без назначения, если не используются
* Проверьте адреса перед большой отправкой
# Attachments (/ru/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Обзор функций (/ru/features/features-overview)
Что надстройка поддерживает сегодня:
| Feature | Docs |
| ------------------------------------------- | ------------------------------------------------------- |
| Start dialog / empty sheet / mock data | [Обзор диалога запуска](/getting-started/start-dialog) |
| Templates (create / manage / edit / delete) | [Шаблоны](/features/templates) |
| Merge tags in **body** | [Теги слияния](/features/merge-tags) |
| Rich-text toolbar | [Форматированные письма](/features/rich-text-emails) |
| Links (not image embeds) | [Изображения](/features/images) |
| Preview + test email | [Предпросмотр и тест](/features/preview-and-test) |
| Schedule send | [Планирование кампаний](/features/campaign-scheduling) |
| Send pacing (paid) | [Send pacing](/features/send-pacing) |
| CC / BCC columns | [Несколько получателей](/features/multiple-recipients) |
| Track emails | [Отслеживание писем](/features/email-tracking) |
| Sender name & reply-to | [Настройка отправителя](/features/customized-sender) |
| Remove branding (paid) | [Удаление брендинга](/features/remove-branding) |
| Stop remaining rows | [Остановка кампании](/features/stopping-a-campaign) |
| Daily quota + review bonus | [Дневная квота и отзывы](/help/daily-quota-and-reviews) |
## Бесплатно vs платно [#бесплатно-vs-платно]
Платно открывает:
* Нестандартный [send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* Более высокие [дневные квоты](/help/account-and-billing)
**Schedule send**, **Track emails** и инструменты шаблонов работают без платного апгрейда.
## Известные ограничения (честно) [#известные-ограничения-честно]
| Topic | Status in product |
| ----------------------- | ------------------------------- |
| Subject merge tags | Not applied at send — body only |
| Attachments column | UI only — not attached on send |
| Image embeds | No editor control — use links |
| Preview CC/BCC lines | Not shown in preview UI |
| Manage Schedule / Pause | Not shipped — status workaround |
## Позже [#позже]
Ссылки отписки, отслеживание кликов, общие места команды и отдельный UI управления кампаниями — когда появятся.
# Отслеживание писем (/ru/features/email-tracking)
MailG может фиксировать открытия крошечным невидимым пикселем.
## Включить отслеживание [#включить-отслеживание]
На боковой панели оставьте **Track emails** вкл. (по умолчанию для новых задач).
Tooltip: `Track emails opened with a tiny pixel`
Иконка справки открывает **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Button: **Got it**
## Статусы в листе [#статусы-в-листе]
| Status | Meaning |
| ------------- | ------------------------------- |
| 🗓️ Scheduled | Waiting for the scheduled start |
| ⏳ Sending… | Currently being processed |
| ✉️ Sent | Delivered to Gmail for that row |
| ⚠️ Failed | Send error for that row |
| 👀 Opened | Open pixel was loaded |
Заголовки столбца кампании: `🚀 Template name (yyyy/MM/dd)` или `🗓️ …` при планировании.
## Обновить отслеживание [#обновить-отслеживание]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Alerts Apps Script:
* `Tracking info synced`
* `No active campaigns`
## Ограничения [#ограничения]
* Клиент должен загружать удалённые изображения
* Privacy-прокси могут скрыть открытия
* Только открытия — не клики
## Связанное [#связанное]
* [Планирование кампаний](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Теги слияния (/ru/features/merge-tags)
Теги слияния дают каждому получателю персонализированное **тело**. Тег — **точный заголовок столбца** в двойных фигурных скобках.
## Синтаксис [#синтаксис]
Если столбец называется `First Name`, используйте:
```text
{{First Name}}
```
Пример тела:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Где работают теги сегодня [#где-работают-теги-сегодня]
| Field | Merged at send? |
| --------------- | -------------------------------------------------- |
| Email body | **Yes** — variables injected per row |
| Email subject | **No** — subject is sent as stored in the template |
| Preview body | **Yes** — for the active row |
| Preview subject | **No** — shows the raw template subject |
Персонализацию в теле — пока merge темы не вышел.
## Вставка тегов [#вставка-тегов]
На панели редактора откройте **Merge Tag**. Список заголовков активного листа. Пусто: `No sheet columns found`.
Вставленный текст — двойные скобки вокруг имени столбца.
## Практические правила [#практические-правила]
* Заголовки чувствительны к регистру (`Name` ≠ `name`)
* Пустые ячейки — пустые строки
* Один тег можно использовать несколько раз в теле
* Получатель / CC / BCC — в **More options**, не через merge tags
## Дальше [#дальше]
См. [Форматированные письма](/features/rich-text-emails) и [Предпросмотр и тест](/features/preview-and-test).
# Форматированные письма (/ru/features/rich-text-emails)
Шаблоны MailG используют rich-text редактор TipTap. HTML из него — то, что доставляет Gmail.
Placeholder тела: `Write your email…`
## Панель инструментов (точный UI) [#панель-инструментов-точный-ui]
| Group | Controls |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (presets in the toolbar) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | Preset swatches + native color picker + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — URL field placeholder `https://example.com`, then **Apply** (and unlink) |
| History | **Undo**, **Redo** |
## Нет в редакторе [#нет-в-редакторе]
Эти возможности TipTap отключены / отсутствуют:
* Headings, code, code block, blockquote, horizontal rule
* Image insert / Drive media picker — см. [Изображения](/features/images)
## Гиперссылки [#гиперссылки]
**Insert link** для URL и видимого текста. Предпочитайте понятный текст ссылки, а не сырой URL.
## Советы [#советы]
* **Merge Tag** вместо ручного ввода скобок
* Предпросмотр нескольких строк перед отправкой — см. [Предпросмотр и тест](/features/preview-and-test)
* Избегайте огромной разметки из Word/Docs; переформатируйте в MailG для чище HTML
# Удаление брендинга MailG (/ru/features/remove-branding)
На free кампаниях может быть небольшой водяной знак MailG в футере. Paid подписчики могут отключить.
## Как убрать брендинг [#как-убрать-брендинг]
1. Активный paid план (Personal, Professional или Lifetime).
2. Боковая панель кампании.
3. Включите **Remove branding**.
4. Предпросмотр строки — водяной знак исчез, затем отправка.
Если брендинг остаётся после оплаты:
* Checkout с **тем же email**, что аккаунт Google Sheets
* Переоткройте надстройку для обновления прав из API
* [contact@mailg.io](mailto:contact@mailg.io) с email Google-аккаунта
См. [Аккаунт и оплата](/help/account-and-billing).
# Изображения (/ru/features/images)
В редакторе MailG **нет кнопки вставки изображения** и выбора медиа Google Drive. Расширение Image TipTap не включено.
## Что можно сегодня [#что-можно-сегодня]
Используйте **Insert link** на панели:
1. Разместите изображение (или файл) по публичному URL или ссылке Drive.
2. Выделите текст (или курсор) → **Insert link**.
3. Вставьте URL (placeholder `https://example.com`) → **Apply**.
Получатели открывают ссылку. Редактор не вставляет `![]()
` за вас.
## Советы [#советы]
* Небольшие файлы и понятный текст («View screenshot»)
* Ссылки с логином не сработают у получателей
* Проверьте **Send me a test email**
## Позже [#позже]
Полноценное встраивание / picker Drive может появиться позже. Пока поддерживаются гиперссылки.
# Шаблоны (/ru/features/templates)
Шаблоны хранят тему и форматированное тело для повторного использования в кампаниях. Они сохраняются в API MailG для вашего аккаунта Google.
## Создать шаблон [#создать-шаблон]
1. На главном экране нажмите **New Template**.
2. Заполните:
* **Template Name**
* **Email Subject**
* Тело (rich editor — см. [Форматированные письма](/features/rich-text-emails))
3. Нажмите **Save Template** (показывает **Saving...** во время работы).
Toasts:
* Loading: `Creating Template...`
* Success: `Template created successfully!`
* Error: `Failed to create template! Try again later.`
Демо из **Fill with mock data**: имя **My First Template**, тема `I found a mail merge tool for Gmail`.
## Управление шаблонами [#управление-шаблонами]
Откройте иконку шаблона рядом с выбором (tooltip **Manage templates**).
Столбцы таблицы:
| Column | Content |
| ----------------- | ------------- |
| **Name** | Template name |
| **Email Subject** | Subject line |
| **Created At** | Creation date |
| **Actions** | Row menu |
Меню строки: **Edit** | **Delete**
Футер: **Back**
Toasts удаления: deleting template NAME → template NAME deleted successfully (или сообщение об ошибке).
## Редактировать шаблон [#редактировать-шаблон]
**Edit** из управления или **Edit template** на панели предпросмотра.
Те же поля, что при создании. **Save Template** обновляет шаблон.
При обновлении toast загрузки (`Updating template...`). Оставайтесь на форме до завершения, затем **Cancel** или **Back**, если не вернулись автоматически.
## Тема vs тело [#тема-vs-тело]
* **Тело** поддерживает [теги слияния](/features/merge-tags) — подставляются по строкам при отправке.
* **Email Subject** отправляется как сохранено (теги в теме **не** заменяются). Персонализацию — в теле или фиксированная тема.
## Связанное [#связанное]
* [Предпросмотр и тест](/features/preview-and-test)
* [Обзор диалога запуска](/getting-started/start-dialog)
# Предпросмотр и тест (/ru/features/preview-and-test)
Панель предпросмотра (справа в главном диалоге) показывает вид письма для активной строки листа.
## Что показывает предпросмотр [#что-показывает-предпросмотр]
| Field | Content |
| ------------ | -------------------------------------------------------------------------------------- |
| **From:** | Your signed-in Google account email |
| **To:** | Value from the **Recipient column** for the active row, or `Select a recipient column` |
| **Subject:** | Template subject as stored (not merge-substituted) |
| Body | Template body with merge tags applied for that row |
Если **Remove branding** выкл., предпросмотр включает водяной знак MailG (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## Чего нет в предпросмотре [#чего-нет-в-предпросмотре]
* **CC** / **BCC** не отображаются (даже при назначении в **More options**). При отправке применяются.
* Значения столбца вложений не показываются.
## Навигация по строкам [#навигация-по-строкам]
Панель предпросмотра:
* **Edit template** — экран обновления шаблона
* **Previous recipient** / **Next recipient** — между строками данных (tooltips могут включать номер строки; заголовок — строка 1, первый контакт — строка 2)
## Отправить мне тестовое письмо [#отправить-мне-тестовое-письмо]
1. Настройте шаблон + столбец получателей для валидного предпросмотра.
2. Меню отправки (chevron) → **Send me a test email**.
3. Оверлей: `Sending test email…`
4. Успех: `Test email sent successfully. Check your inbox.`
5. Ошибка: `Failed to send test email. Please check your email settings.`
6. Блок при неполном предпросмотре: `Configure your preview first`
Тест идёт во **входящие вашего** Google-аккаунта с объединённым телом активной строки.
## Советы [#советы]
* Пройдите несколько строк стрелками перед полной отправкой
* Проверьте branding / без branding в предпросмотре
* Всегда тест перед **Schedule send** или большим **Send N email(s)**
## Связанное [#связанное]
* [Теги слияния](/features/merge-tags)
* [Урок mail merge](/getting-started/mail-merge-tutorial)
# Темп отправки (/ru/features/send-pacing)
Send pacing добавляет задержку между сообщениями, чтобы большая кампания не ушла одним залпом.
**Steady pace** и **Jittered gaps** требуют активной paid подписки MailG. Free — только **Burst send**.
## Где настроить [#где-настроить]
Шестерёнка в футере (tooltip **Send pacing**). Screen heading: **Send pacing**.
Под **Dispatch mode** — интервал между письмами. **Gap between emails** в **seconds** (0–60). На free — **Pro features** и текст: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
По умолчанию для новых задач: **Burst send**, gap **10s** (gap игнорируется в burst).
## Режимы [#режимы]
| Mode (UI label) | Behavior |
| ------------------------ | ----------------------------------------------- |
| **Burst send** (default) | Send as quickly as quotas allow |
| **Steady pace** | Wait a fixed gap between each email |
| **Jittered gaps** | Wait a random gap between 0 and your chosen max |
## Зачем pacing [#зачем-pacing]
* Меньше риска «внезапного залпа» для почтовых провайдеров
* Растянуть длинный список на спокойное окно
* В пределах комфорта Gmail для типа аккаунта
## Заметки [#заметки]
* Pacing — настройка кампании с задачей; новые отправки берут текущую конфигурацию
* Большой gap на длинном списке сильно увеличивает длительность
* Скорость ограничена дневной квотой MailG **и** остатком Gmail
* У конкурентов задержка иногда в минутах — MailG в **seconds**
## Связанное [#связанное]
* [Остановка кампании](/features/stopping-a-campaign) если gap слишком большой
* [Аккаунт и оплата](/help/account-and-billing)
# Остановка кампании (/ru/features/stopping-a-campaign)
MailG пока без отдельного экрана **Manage Schedule**, **Abort** или **Pause**. Можно остановить **оставшиеся** строки.
## Что обрабатывает отправка [#что-обрабатывает-отправка]
Цикл отправки берёт только строки со «отправляемым» статусом в столбце кампании:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
**✉️ Sent**, **⚠️ Failed**, **👀 Opened** пропускаются.
## Остановить оставшиеся строки (честный обход) [#остановить-оставшиеся-строки-честный-обход]
Действуйте быстро на большой кампании:
1. Откройте таблицу.
2. В столбце статуса очистите или измените статус строк, которые **не** должны отправиться (удалите значение или метку вроде `Stopped`).
3. Не трогайте **✉️ Sent** — письма уже ушли.
Очищенные/изменённые строки не совпадут с отправляемыми статусами — очередь пропустит их.
Письма Gmail, уже ушедшие с аккаунта, MailG не отменит. Остановка защищает только необработанные строки.
## Запланированные кампании до старта [#запланированные-кампании-до-старта]
Если все строки **🗓️ Scheduled** и время не наступило, очистка статусов (или столбца) не даст очереди взять их в срок.
При сомнениях — [contact@mailg.io](mailto:contact@mailg.io) с URL таблицы и деталями кампании.
## Связанное [#связанное]
* [Планирование кампаний](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Настройка отправителя (/ru/features/customized-sender)
По умолчанию Gmail отправляет с аккаунта, авторизовавшего MailG. Можно настроить отображаемое имя и адрес для ответов.
## Имя отправителя [#имя-отправителя]
1. **More options** на боковой панели кампании.
2. **Sender name** (placeholder `John Doe (Optional)`).
3. Получатели видят это имя во входящих (по правилам Gmail).
## Адрес для ответа [#адрес-для-ответа]
**Reply to address** (placeholder `john@doe.com (Optional)`), если ответы должны идти не на аккаунт отправки.
## Заметки [#заметки]
* From остаётся авторизованным Gmail — нельзя подменить чужой ящик
* Невалидный reply-to — проблемы доставки/ответов; используйте свой ящик
* Предпросмотр **From:** — ваш email; reply-to — **Send me a test email**
* См. [Предпросмотр и тест](/features/preview-and-test)
# Обзор диалога запуска (/ru/getting-started/start-dialog)
Откройте надстройку через **Extensions → MailG for Gmail → 🚀 Start**. Откроется диалог 900×600 с заголовком **MailG for Gmail**.
## Экраны [#экраны]
| Screen | How you get there | Purpose |
| ------------------ | -------------------------------------------- | ----------------------------------------- |
| Root (composer) | Default after load | Pick template + recipients, preview, send |
| Create template | **New Template** | Name, subject, body |
| Manage templates | Template icon (tooltip **Manage templates**) | List, edit, delete |
| Update template | **Edit template** or row **Edit** | Edit an existing template |
| Settings | Footer gear (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | No valid email column | Prompt to add contacts or mock data |
| API / sheet errors | Load failure | Retry guidance |
## Главная раскладка [#главная-раскладка]
Три зоны:
1. **Sidebar** (слева) — шаблон, столбец получателей, **More options**, отслеживание, брендинг, квота
2. **Preview** (справа) — From / To / Subject / тело, навигация по строкам, **Edit template**
3. **Footer** — кнопка отправки, меню отправки, **Upgrade to Pro** (free), настройки, справка
## Элементы боковой панели (точные подписи) [#элементы-боковой-панели-точные-подписи]
* **New Template**
* **Template** (select) — placeholder `Select` or `No templates found`
* **Recipient column** — варианты вроде `A - Email`; пусто: `No valid email columns found.`
* **More options** — раскрывает **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (по умолчанию вкл.)
* **Remove branding** (paid)
* **Daily quota** — остаток как «N left» и строка плана «Your plan sends up to TOTAL/day»
На free также **Leave a 5★ review for +N/day free** и **Or upgrade your plan**. См. [Дневная квота и отзывы](/help/daily-quota-and-reviews).
## Элементы отправки в футере [#элементы-отправки-в-футере]
| Control | Label |
| -------------- | ------------------------------------------------------------------------------------- |
| Primary button | **Send N email(s)** (or **Send emails** when count is 0) |
| Send menu | **Send me a test email** |
| Send menu | **Schedule send** |
| Upgrade (free) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Gear | tooltip **Send pacing** |
| Help | tooltip **Help** — opens the in-dialog checklist |
### Чеклист Need help? [#чеклист-need-help]
1. Pick a template and recipient column
2. Preview each row with the arrows
3. Send a test email to yourself first
4. Click Send to merge from your sheet
Buttons: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (if available) | **Close**
## Пустой лист [#пустой-лист]
Если MailG не находит валидный столбец email:
* Title: **No email address found in your sheet**
* Actions: **Close** | **Fill with mock data**
Mock data создаёт заголовки `Email`, `First Name`, `Last Name`, `Company` и может создать **My First Template**.
## Экраны ошибок [#экраны-ошибок]
| Title | When |
| --------------------------------- | --------------------- |
| **Could not reach the MailG API** | API / network failure |
| **Could not read your sheet** | Sheet read failure |
## Дальше [#дальше]
# Установка (/ru/getting-started/installation)
Два шага: установить надстройку, затем запустить из Sheets.
## Установить MailG [#установить-mailg]
1. Откройте [страницу MailG в Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Нажмите **Install**.
3. Выберите аккаунт Google, которому принадлежит установка.
4. Просмотрите разрешения и нажмите **Allow**.
Установка обычно занимает менее 15 секунд. Должно появиться подтверждение установки.
Если листинг Marketplace ещё недоступен в вашем регионе, используйте кнопку установки на [www.mailg.io](https://www.mailg.io) или напишите на [contact@mailg.io](mailto:contact@mailg.io).
## Запустить MailG в Google Sheets [#запустить-mailg-в-google-sheets]
1. Откройте [Google Sheets](https://sheets.google.com) (обновите, если Sheets уже был открыт).
2. Подождите несколько секунд загрузки Extensions (часто \~10–15 секунд).
3. Перейдите в **Extensions → MailG for Gmail → 🚀 Start**.
Позже можно выполнить **Extensions → MailG for Gmail → 🔄 Refresh Tracking**, чтобы синхронизировать статусы открытия без полного диалога.
## Проблемы установки [#проблемы-установки]
Это типичные особенности Google Workspace, а не ошибки MailG:
### Не появляется окно «успешно установлено» [#не-появляется-окно-успешно-установлено]
Часто при нескольких аккаунтах Google установка прошла не на тот аккаунт.
**Обход:** откройте приватное/инкognito-окно, войдите только в нужный аккаунт и установите снова из Marketplace.
### MailG не виден в Extensions [#mailg-не-виден-в-extensions]
1. Обновите таблицу.
2. Подождите \~10–15 секунд загрузки надстроек.
3. Убедитесь, что вы в том же аккаунте Google, где установлен MailG.
4. Попробуйте другую таблицу или очистите кэш браузера.
## Самостоятельный / кастомный деплой [#самостоятельный--кастомный-деплой]
Установки из Marketplace преднастроены. При своём деплое задайте свойства Apps Script:
| Property | Value |
| ------------- | ------------------------------------ |
| `APP_URL` | Публичный HTTPS URL вашего API MailG |
| `APP_API_KEY` | Тот же ключ, что на сервере API |
Надстройка не может обращаться к `localhost` с серверов Google — для локальных тестов используйте туннель (Cloudflare Tunnel, ngrok и т. д.).
## Дальше [#дальше]
Продолжите [уроком mail merge](/getting-started/mail-merge-tutorial).
# Урок mail merge (/ru/getting-started/mail-merge-tutorial)
Этот сценарий соответствует диалогу запуска **MailG for Gmail**.
## 1. Открыть MailG [#1-открыть-mailg]
**Extensions → MailG for Gmail → 🚀 Start**.
Если видите **No email address found in your sheet**, добавьте реальные адреса или нажмите **Fill with mock data** (создаёт примеры строк и часто **My First Template**). См. [Обзор диалога запуска](/getting-started/start-dialog).
## 2. Создать или выбрать шаблон [#2-создать-или-выбрать-шаблон]
1. Нажмите **New Template** (или выберите существующий в **Template**).
2. Задайте **Template Name** и **Email Subject** (тема **не** подставляется через merge сегодня).
3. Напишите тело и вставьте [теги слияния](/features/merge-tags) через **Merge Tag**.
4. **Save Template**.
Пример тела:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Настроить кампанию [#3-настроить-кампанию]
На боковой панели:
1. Выберите **Recipient column** (в ячейках должен быть один валидный email для подсчёта в UI).
2. Откройте **More options** для **CC**, **BCC**, **Sender name**, **Reply to address**.
3. Оставьте **Track emails** включённым (по умолчанию), если нужен статус открытия в листе.
4. На платном плане включите **Remove branding**.
**Attachments** есть в **More options**, но файлы пока не прикрепляются при отправке. Вместо этого ссылка на Drive или URL в теле.
## 4. Предпросмотр и тест [#4-предпросмотр-и-тест]
1. Стрелками переключайте строки.
2. Проверьте **To:** и объединённое тело (тема — сырая из шаблона).
3. Меню отправки → **Send me a test email**.
4. Проверьте входящие.
Подробнее: [Предпросмотр и тест](/features/preview-and-test).
## 5. Отправить или запланировать [#5-отправить-или-запланировать]
* Основная кнопка: **Send N email(s)** при подсчитанных получателях.
* Или меню отправки → **Schedule send** → дата/время → **Schedule Send**.
Оверлеи: `Starting your campaign…` / toasts подтверждения планирования.
MailG добавляет столбец кампании вроде `🚀 My Template (yyyy/MM/dd)` или `🗓️ …` при планировании.
Статусы строк:
| Status | Meaning |
| ------------- | ----------------- |
| 🗓️ Scheduled | Waiting for start |
| ⏳ Sending… | Processing |
| ✉️ Sent | Handed to Gmail |
| ⚠️ Failed | Error |
| 👀 Opened | Open pixel loaded |
## Частые ошибки [#частые-ошибки]
* Теги в теме — персонализация только в теле пока
* Несколько адресов через запятую в ячейке — UI считает **one** email на ячейку
* Неверный аккаунт Google vs аккаунт установки
* Исчерпана дневная квота — смотрите **Daily quota** на боковой панели
## Советы [#советы]
* Используйте чеклист **Help** в футере в первый раз
* Начните с 2–3 реальных строк после mock data
* После открытий: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alert `Tracking info synced` (или `No active campaigns`)
## Дальше [#дальше]
# Что такое MailG? (/ru/getting-started/what-is-mailg)
MailG превращает Google Sheet в кампанию mail merge. Каждая строка — получатель; заголовки столбцов становятся тегами слияния (двойные фигурные скобки вокруг имени заголовка) в **теле письма**.
## Что можно делать [#что-можно-делать]
* Создавать облачные шаблоны (**Template Name**, **Email Subject**, форматированное тело)
* Персонализировать **тело** тегами слияния из заголовков листа
* Просматривать строки и **Send me a test email**
* Назначать **CC** / **BCC**, **Sender name**, **Reply to address**
* **Schedule send** или отправлять сразу
* **Track emails** со статусами открытия в листе
* Управлять **Send pacing** на платных планах
* **Remove branding** на платных планах
* Следить за **Daily quota** (и при желании получить бонус за отзыв)
## Как всё связано [#как-всё-связано]
1. **Надстройка Google Sheets** — диалог в **MailG for Gmail**
2. **API MailG** — шаблоны, метаданные кампаний, отслеживание открытий, права
3. **Ваш Gmail** — письма через `GmailApp` с авторизованного аккаунта
## Дальше [#дальше]
# हमसे संपर्क करें (/hi/contact-us)
## बिलिंग और सब्सक्रिप्शन [#बिलिंग-और-सब्सक्रिप्शन]
अधिकांश सब्सक्रिप्शन बदलाव [pricing](https://app.mailg.io/pricing?lang=hi) से जुड़े Stripe पोर्टल से कर सकते हैं। रिफंड या भुगतान समस्याओं के लिए ईमेल करें।
## बाकी सब [#बाकी-सब]
**[contact@mailg.io](mailto:contact@mailg.io)** पर ईमेल करें।
हम आमतौर पर एक कार्य दिवस में जवाब देते हैं।
## उपयोगी लिंक [#उपयोगी-लिंक]
* [वेबसाइट](https://www.mailg.io)
* [मूल्य](https://app.mailg.io/pricing?lang=hi)
* [गोपनीयता](https://www.mailg.io/hi/privacy)
* [नियम](https://www.mailg.io/hi/terms)
* [दस्तावेज़ होम](/)
# MailG दस्तावेज़ (/hi)
MailG Gmail के साथ mail merge के लिए Google Sheets ऐड-ऑन है। **Extensions → MailG for Gmail → 🚀 Start** खोलें, टेम्पलेट बनाएँ, पंक्तियाँ देखें, फिर अपने Gmail खाते से भेजें या शेड्यूल करें।
## यहाँ से शुरू करें [#यहाँ-से-शुरू-करें]
## लोकप्रिय विषय [#लोकप्रिय-विषय]
## उपयोगी लिंक [#उपयोगी-लिंक]
* वेबसाइट: [www.mailg.io](https://www.mailg.io)
* दस्तावेज़: [docs.mailg.io/hi](https://docs.mailg.io/hi)
* मूल्य: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=hi)
* संपर्क: [contact@mailg.io](mailto:contact@mailg.io)
## AI सहायक / LLM के लिए [#ai-सहायक--llm-के-लिए]
HTML स्क्रैप करने के बजाय इन मशीन-पठनीय एंडपॉइंट को प्राथमिकता दें:
* [Agents hub](https://www.mailg.io/hi/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/hi/help/faq)
## इंस्टॉलेशन और खोलना [#इंस्टॉलेशन-और-खोलना]
**MailG कैसे खोलूँ?**\
**Extensions → MailG for Gmail → 🚀 Start**. [Installation](/getting-started/installation) देखें।
**No email address found in your sheet**\
Column में emails जोड़ें, या **Fill with mock data** click करें। [Start dialog tour](/getting-started/start-dialog) देखें।
**Could not reach the MailG API**\
Network / API URL check करें (self-hosted: `APP_URL` + `APP_API_KEY`). Fix के बाद dialog reopen करें।
## भेजना [#भेजना]
**Emails send नहीं हो रहे**\
**Daily quota**, Gmail permissions, और **Recipient column** cells valid single emails check करें। Failures **⚠️ Failed** दिखाते हैं।
**Subject merge tags काम करते हैं?**\
अभी नहीं। केवल **body** merge होता है। Fixed subject रखें या personalization body में। [Merge tags](/features/merge-tags) देखें।
**Files attach कर सकता हूँ?**\
**Attachments** picker **More options** के अंतर्गत है, लेकिन files send पर attach नहीं होतीं yet। Links उपयोग करें।
**Campaign कैसे stop करूँ?**\
[Stopping a campaign](/features/stopping-a-campaign) — remaining rows पर sendable statuses clear करें।
**Professional पर limited क्यों?**\
MailG 1,500/day allow कर सकता है, लेकिन free `@gmail.com` Google द्वारा \~500 near cap होता है।
## ट्रैकिंग [#ट्रैकिंग]
**Open के बाद sheet अभी Sent कहता है**\
**🔄 Refresh Tracking** → `Tracking info synced` expect करें। कुछ clients images load नहीं करते।
**Clicks?**\
Tracked नहीं। **Track emails** = opens only.
## Quota और billing [#quota-और-billing]
[Daily quota & reviews](/help/daily-quota-and-reviews) और [Account & billing](/help/account-and-billing) देखें।
**Schedule send paid है?**\
नहीं। Paid higher quotas, pacing modes, और **Remove branding** unlock करता है।
## समस्या निवारण [#समस्या-निवारण]
Step-by-step fixes (API errors, empty sheet, disabled send button, failed rows, tracking, quota, schedule not deferring): [Troubleshooting](/help/troubleshooting).
Common toasts:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## अभी भी अटके? [#अभी-भी-अटके]
[Troubleshooting](/help/troubleshooting) · Docs [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# समस्या निवारण (/hi/help/troubleshooting)
ऐड-ऑन में दिखने वाले messages और states के quick fixes।
## Dialog load नहीं होता [#dialog-load-नहीं-होता]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
Start dialog MailG backend call नहीं कर सका।
* Online confirm करें
* Marketplace installs: moment wait करें और **🚀 Start** reopen
* Self-hosted: Apps Script properties `APP_URL` (public HTTPS) और `APP_API_KEY` check
* ऐड-ऑन `localhost` use नहीं कर सकता — local API testing के लिए tunnel
### Could not read your sheet [#could-not-read-your-sheet]
MailG active spreadsheet read fail।
* Sheet tab open हो (केवल Apps Script editor नहीं)
* Spreadsheet reload, फिर dialog reopen
* File पर edit access confirm
### Loading… never finishes [#loading-never-finishes]
Dialog close, Sheets refresh, Extensions \~15 seconds wait, फिर **🚀 Start** again.
## खाली sheet [#खाली-sheet]
**No email address found in your sheet**
MailG को कम से कम एक column valid email addresses चाहिए।
* Header के अंतर्गत emails add, या **Fill with mock data** click
* Mock data `Email`, `First Name`, `Last Name`, `Company` बनाता है और अक्सर **My First Template**
[Start dialog tour](/getting-started/start-dialog) देखें।
## टेम्पलेट [#टेम्पलेट]
* Create: `Creating Template...` → `Template created successfully!` or `Failed to create template! Try again later.`
* Update: `Updating template...`
* Delete failures: `Failed to delete template. Try again later`
[Templates](/features/templates) देखें।
## भेजने की समस्याएँ [#भेजने-की-समस्याएँ]
### Send button disabled / Send emails with no count [#send-button-disabled--send-emails-with-no-count]
* **Template** select
* Valid **single** emails per cell वाला **Recipient column** select
* Guard toasts: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### Campaign fails to start [#campaign-fails-to-start]
Toast: `Failed to create campaign. Please try again.`
* Once retry
* **Daily quota** 0 न हो check
* API connectivity confirm (ऊपर)
### Rows show ⚠️ Failed [#rows-show-️-failed]
उस row send error (invalid address, Gmail rejection, transient quota, etc.)। Data fix कर remaining rows new campaign start, या [Stopping a campaign](/features/stopping-a-campaign) देखें।
### Test email fails [#test-email-fails]
* `Configure your preview first` — template + recipient pick ताकि preview To हो
* `Failed to send test email. Please check your email settings.` — Gmail re-authorize, retry
## ट्रैकिंग [#ट्रैकिंग]
* Opens के लिए recipient remote images load करे
* **🔄 Refresh Tracking** run — `Tracking info synced` or `No active campaigns` expect
* Status **👀 Opened** pixel load होने पर only
[Email tracking](/features/email-tracking) देखें।
## Quota और branding [#quota-और-branding]
* Sidebar **N left** is `min(MailG remaining, Gmail remaining)`
* Free `@gmail.com` Professional पर भी Google \~500/day cap
* Pay के बाद watermark — checkout email Sheets account match; dialog reopen
[Daily quota & reviews](/help/daily-quota-and-reviews) और [Remove branding](/features/remove-branding) देखें।
## Schedule defer नहीं हुआ [#schedule-defer-नहीं-हुआ]
\~**15 seconds** से कम ahead times **immediate** send (🚀 column), deferred 🗓️ schedule नहीं। Future में समय pick करें।
## अभी भी अटके? [#अभी-भी-अटके]
पूरी FAQ: [FAQ](/help/faq) · ईमेल [contact@mailg.io](mailto:contact@mailg.io) · साइट [app.mailg.io/help](https://www.mailg.io/hi/help)
# दैनिक कोटा और समीक्षाएँ (/hi/help/daily-quota-and-reviews)
Root sidebar sending capacity दिखाता है जब account data loaded हो।
## Daily quota ब्लॉक [#daily-quota-ब्लॉक]
Exact UI:
* Label: **Daily quota**
* Remaining: **N left**
* Plan line: **Your plan sends up to TOTAL/day**
**Remaining** minimum है:
1. MailG plan remaining for the day
2. Gmail remaining send quota for the account
Paper पर MailG headroom हो तब भी Gmail cap लग सकता है। [Account & billing](/help/account-and-billing) भी देखें।
## Free plan CTA [#free-plan-cta]
Unsubscribed होने पर sidebar दिखा सकता है:
* **Leave a 5★ review for +N/day free** (default bonus **+50/day** जब API otherwise specify न करे)
* **Or upgrade your plan**
Review CTA click **Free Quota upgrade** खोलता है:
* Title: **Free Quota upgrade**
* Body: leave a 5-star review to get a free quota upgrade of **+N emails/day**
* Buttons: **Not now** | **Leave a 5★ review**
Review URL configured न हो तो **Leave a 5★ review** disabled — **Upgrade to Pro** / pricing उपयोग करें।
## Pro में अपग्रेड करें [#pro-में-अपग्रेड-करें]
Footer button (free accounts): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
Paid plans आज product में unlock करते हैं वही match करता है।
## संबंधित [#संबंधित]
* [Remove branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# खाता और बिलिंग (/hi/help/account-and-billing)
MailG billing Sheets में **Google account email** से tied है। Quotas unlock करने के लिए हमेशा **same address** से checkout करें।
## Plans और daily quotas [#plans-और-daily-quotas]
| Plan | Daily quota | Notes |
| ------------ | ----------- | ------------------------------------- |
| Free | 50 | Core merge, open tracking, scheduling |
| Personal | 250 | Popular plan for growing lists |
| Professional | 1,500 | Highest recurring quota |
| Lifetime | 1,500 | One-time purchase |
कीमतें और अंतराल [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=hi) पर (EUR और USD).
Paid entitlements unlock:
* Non-default [send pacing](/features/send-pacing) (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Effective send volume `min(MailG daily quota, Gmail remaining quota)` है।
## Upgrade कैसे करें [#upgrade-कैसे-करें]
1. [मूल्य](https://app.mailg.io/pricing?lang=hi) खोलें (**Upgrade to Pro** से ऐड-ऑन link भी)।
2. Plan चुनें और Sheets Google email से Stripe Checkout complete करें।
3. MailG Sheets में फिर खोलें ताकि account refresh new limit pick up करे।
## Subscription cancel या update [#subscription-cancel-या-update]
Subscription / pricing flow से linked Stripe customer portal से cancel या change कर सकते हैं।
* Mid-cycle cancel पर Premium features paid period end तक active
* Cancellation effective होने के बाद charge नहीं
## रिफंड [#रिफंड]
Purchase के **30 days** के अंदर Premium subscription cancel करें तो [contact@mailg.io](mailto:contact@mailg.io) email कर full refund request कर सकते हैं।
## इनवॉइस [#इनवॉइस]
Stripe successful payments के receipts email करता है। Subscription management portal से invoices download भी कर सकते हैं।
## सामान्य FAQ [#सामान्य-faq]
**क्या MailG Google Workspace में included है?**\
नहीं। MailG Google से independent है। Workspace subscription MailG include नहीं करता।
**कौन से payment methods accept?**\
Major cards, Google Pay, Apple Pay Stripe के ज़रिए। PayPal supported नहीं।
**Pay किया लेकिन free limit / watermark अभी दिखता है**\
Almost always email mismatch। Checkout email = Sheets account email confirm करें, फिर ऐड-ऑन reopen। Persist हो तो दोनों emails support को भेजें।
**Free Gmail \~500 emails/day पर limited क्यों?**\
MailG Professional 1,500/day allow कर सकता है, लेकिन Google free `@gmail.com` \~500 sends/day limit करता है। Workspace accounts higher जा सकते हैं। Gmail provider limit है, MailG limit नहीं।
# कैंपेन शेड्यूलिंग (/hi/features/campaign-scheduling)
बाद में शुरू करना हो तो **Schedule send** उपयोग करें। Free और paid plans दोनों पर उपलब्ध।
## Schedule कैसे करें [#schedule-कैसे-करें]
1. Template और recipients configure करें ताकि send button enabled हो।
2. Send menu (chevron) → **Schedule send** खोलें।
3. Dialog title: **Schedule send**
4. Description: `Pick date & time to schedule sending`
5. Summary line: chosen date/time से शुरू होने वाले N emails schedule करना
6. Date picker और **Hour** / **Minute** (placeholders `Hour`, `Min`) उपयोग करें।
7. **Schedule Send** (या **Cancel**) से confirm करें।
Default suggestion लगभग **60 minutes ahead** है, अगले **15-minute** step पर snapped।
## तुरंत बनाम scheduled [#तुरंत-बनाम-scheduled]
लगभग **15 seconds** से कम आगे के times **immediate** send (🚀 column header) माने जाते हैं, deferred 🗓️ schedule नहीं। Deferred sending के लिए भविष्य में समय चुनें।
Validation toasts: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Success toast: campaign scheduled; N emails chosen time पर start होंगे।
## स्प्रेडशीट column [#स्प्रेडशीट-column]
Scheduled campaigns column header बनाते हैं जैसे:
```text
🗓️ Template name (yyyy/MM/dd)
```
Immediate sends 🗓️ की जगह 🚀 उपयोग करते हैं।
Rows **🗓️ Scheduled** से शुरू होती हैं, queue चलने पर **⏳ Sending…** में जाती हैं।
## Schedule के बाद [#schedule-के-बाद]
* Spreadsheet उस Google account के लिए accessible रखें जिसने ऐड-ऑन own किया
* Sending start होने पर tracking और pacing लागू रहते हैं
* **Manage Schedule** UI नहीं — [Stopping a campaign](/features/stopping-a-campaign) देखें
## संबंधित [#संबंधित]
* [Preview & test](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# कई प्राप्तकर्ता (/hi/features/multiple-recipients)
Dedicated sheet columns से प्रति row carbon-copy recipients जोड़ सकते हैं।
## प्राप्तकर्ता column (To) [#प्राप्तकर्ता-column-to]
Sidebar में **Recipient column** select करें।
Send button count और column validation के लिए MailG cell को valid मानता है जब वह **single** email address हो। प्रति row एक primary To address prefer करें।
## CC और BCC columns [#cc-और-bcc-columns]
1. Sheet में columns जोड़ें (उदाहरण `CC` और `BCC`).
2. Cell में email (या Gmail-accepted list) डालें।
3. **More options** खोलकर **CC** / **BCC** map करें।
4. Send time पर values Gmail को pass होती हैं।
Preview pane केवल **From**, **To**, **Subject**, और body दिखाता है। Mapped होने पर भी CC/BCC lines **not** displayed। CC/BCC delivery verify करने के लिए **Send me a test email** से confirm करें।
## Quotas: MailG बनाम Gmail [#quotas-mailg-बनाम-gmail]
* **MailG daily quota** processed **campaign rows** गिनता है।
* **Gmail sending limits** **recipients** गिनते हैं (To + CC + BCC addresses जो Gmail उस send पर accept करता है)।
MailG quota बचा हो तब भी Gmail cap लग सकता है।
## सुझाव [#सुझाव]
* Recipients एक-दूसरे को न देखें तो **BCC** prefer करें
* Unused हो तो CC/BCC unmapped रखें
* Large send से पहले addresses validate करें
# Attachments (/hi/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# फ़ीचर्स अवलोकन (/hi/features/features-overview)
ऐड-ऑन आज क्या सपोर्ट करता है:
| Feature | Docs |
| ------------------------------------------- | ------------------------------------------------------ |
| Start dialog / empty sheet / mock data | [Start dialog tour](/getting-started/start-dialog) |
| Templates (create / manage / edit / delete) | [Templates](/features/templates) |
| Merge tags in **body** | [Merge tags](/features/merge-tags) |
| Rich-text toolbar | [Rich-text emails](/features/rich-text-emails) |
| Links (not image embeds) | [Images](/features/images) |
| Preview + test email | [Preview & test](/features/preview-and-test) |
| Schedule send | [Campaign scheduling](/features/campaign-scheduling) |
| Send pacing (paid) | [Send pacing](/features/send-pacing) |
| CC / BCC columns | [Multiple recipients](/features/multiple-recipients) |
| Track emails | [Email tracking](/features/email-tracking) |
| Sender name & reply-to | [Customized sender](/features/customized-sender) |
| Remove branding (paid) | [Remove branding](/features/remove-branding) |
| Stop remaining rows | [Stopping a campaign](/features/stopping-a-campaign) |
| Daily quota + review bonus | [Daily quota & reviews](/help/daily-quota-and-reviews) |
## Paid बनाम free [#paid-बनाम-free]
Paid unlocks:
* Non-default [send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* Higher [daily quotas](/help/account-and-billing)
**Schedule send**, **Track emails**, और template tools paid upgrade के बिना काम करते हैं।
## ज्ञात अंतराल (ईमानदारी से) [#ज्ञात-अंतराल-ईमानदारी-से]
| Topic | Status in product |
| ----------------------- | ------------------------------- |
| Subject merge tags | Not applied at send — body only |
| Attachments column | UI only — not attached on send |
| Image embeds | No editor control — use links |
| Preview CC/BCC lines | Not shown in preview UI |
| Manage Schedule / Pause | Not shipped — status workaround |
## बाद में आ रहा है [#बाद-में-आ-रहा-है]
Unsubscribe links, click tracking, shared team seats, और dedicated campaign manager UI जब ship होंगे।
# ईमेल ट्रैकिंग (/hi/features/email-tracking)
MailG tiny invisible pixel से opens record कर सकता है।
## Tracking enable करें [#tracking-enable-करें]
Sidebar में **Track emails** on रखें (new jobs के लिए default on)।
Tooltip: `Track emails opened with a tiny pixel`
Help icon **Email tracking** खोलता है:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Button: **Got it**
## शीट स्थितियाँ [#शीट-स्थितियाँ]
| Status | Meaning |
| ------------- | ------------------------------- |
| 🗓️ Scheduled | Waiting for the scheduled start |
| ⏳ Sending… | Currently being processed |
| ✉️ Sent | Delivered to Gmail for that row |
| ⚠️ Failed | Send error for that row |
| 👀 Opened | Open pixel was loaded |
Campaign column headers `🚀 Template name (yyyy/MM/dd)` या schedule होने पर `🗓️ …` जैसे दिखते हैं।
## Refresh Tracking [#refresh-tracking]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Apps Script alerts:
* `Tracking info synced`
* `No active campaigns`
## सीमाएँ [#सीमाएँ]
* Client को remote images load करनी होंगी
* Privacy proxies opens छिपा सकते हैं
* Opens only — link clicks नहीं
## संबंधित [#संबंधित]
* [Campaign scheduling](/features/campaign-scheduling)
* [FAQ](/help/faq)
# मर्ज टैग (/hi/features/merge-tags)
Merge tags हर recipient को personalized **body** देते हैं। Tag **exact column header** है जो double curly braces में wrapped है।
## सिंटैक्स [#सिंटैक्स]
अगर sheet में `First Name` नाम का column है, उपयोग करें:
```text
{{First Name}}
```
Body example:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Merge tags आज कहाँ काम करते हैं [#merge-tags-आज-कहाँ-काम-करते-हैं]
| Field | Merged at send? |
| --------------- | -------------------------------------------------- |
| Email body | **Yes** — variables injected per row |
| Email subject | **No** — subject is sent as stored in the template |
| Preview body | **Yes** — for the active row |
| Preview subject | **No** — shows the raw template subject |
Subject merge ship होने तक personalization body में रखें।
## Tags insert करना [#tags-insert-करना]
Editor toolbar में **Merge Tag** खोलें। Active sheet के headers list करता है। Empty state: `No sheet columns found`.
Inserted text column name के चारों ओर double curly braces उपयोग करता है।
## सामान्य नियम [#सामान्य-नियम]
* Headers case-sensitive हैं (`Name` ≠ `name`)
* Empty cells empty strings insert करते हैं
* Body में same tag कई बार reuse कर सकते हैं
* Recipient / CC / BCC **More options** के अंतर्गत चुने जाते हैं, merge tags से नहीं
## अगला [#अगला]
[Rich-text emails](/features/rich-text-emails) और [Preview & test](/features/preview-and-test) देखें।
# रिच-टेक्स्ट ईमेल (/hi/features/rich-text-emails)
MailG templates TipTap rich-text editor उपयोग करते हैं। जो HTML produce होता है वही Gmail deliver करता है।
Body placeholder: `Write your email…`
## Toolbar सूची (सटीक UI) [#toolbar-सूची-सटीक-ui]
| Group | Controls |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (presets in the toolbar) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | Preset swatches + native color picker + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — URL field placeholder `https://example.com`, then **Apply** (and unlink) |
| History | **Undo**, **Redo** |
## Editor में नहीं [#editor-में-नहीं]
ये TipTap features disabled / absent हैं:
* Headings, code, code block, blockquote, horizontal rule
* Image insert / Drive media picker — [Images](/features/images) देखें
## हाइपरलिंक [#हाइपरलिंक]
URL और visible text के लिए **Insert link** उपयोग करें। Raw URLs की बजाय clear link text prefer करें।
## सुझाव [#सुझाव]
* Braces हाथ से type करने की बजाय **Merge Tag** उपयोग करें
* Send से पहले कई rows preview करें — [Preview & test](/features/preview-and-test) देखें
* बड़ा pasted Word/Docs markup avoid करें; cleaner HTML के लिए MailG में formatting फिर apply करें
# MailG ब्रांडिंग हटाएँ (/hi/features/remove-branding)
Free campaigns में email footer में छोटा MailG watermark हो सकता है। Paid subscribers इसे off कर सकते हैं।
## Branding कैसे हटाएँ [#branding-कैसे-हटाएँ]
1. Active paid plan confirm करें (Personal, Professional, या Lifetime).
2. Campaign sidebar खोलें।
3. **Remove branding** enable करें।
4. Row preview करके watermark gone confirm करें, फिर send करें।
Pay के बाद भी branding दिखे:
* Checkout **same email** से हुआ हो जो Google Sheets account है
* API से entitlements refresh करने के लिए ऐड-ऑन फिर खोलें
* Google account email के साथ [contact@mailg.io](mailto:contact@mailg.io) से संपर्क करें
[Account & billing](/help/account-and-billing) देखें।
# छवियाँ (/hi/features/images)
MailG editor में **no image insert button** और Google Drive media picker नहीं है। TipTap का Image extension enabled नहीं है।
## आज क्या कर सकते हैं [#आज-क्या-कर-सकते-हैं]
Toolbar में **Insert link** उपयोग करें:
1. Image (या file) public URL पर host करें, या Drive link share करें।
2. Text select करें (या cursor रखें) → **Insert link**.
3. URL paste करें (placeholder `https://example.com`) → **Apply**.
Recipients link खोलकर image या file देखते हैं। Editor आपके लिए `![]()
` tags embed नहीं करता।
## सुझाव [#सुझाव]
* छोटी files और clear link text (“View screenshot”) prefer करें
* Login चाहने वाले links recipients के लिए fail होंगे
* **Send me a test email** से confirm करें
## बाद में आ रहा है [#बाद-में-आ-रहा-है]
First-class image embed / Drive picker बाद में ship हो सकता है। तब तक hyperlinks supported path हैं।
# टेम्पलेट (/hi/features/templates)
Templates subject और rich-text body store करते हैं जो campaigns में reuse होते हैं। आपके Google account के लिए MailG API में save होते हैं।
## Template create करें [#template-create-करें]
1. Root screen पर **New Template** पर क्लिक करें।
2. Fill in:
* **Template Name**
* **Email Subject**
* Body (rich editor — [Rich-text emails](/features/rich-text-emails) देखें)
3. **Save Template** पर क्लिक करें (**Saving...** working के दौरान दिखता है)।
Toasts:
* Loading: `Creating Template...`
* Success: `Template created successfully!`
* Error: `Failed to create template! Try again later.`
**Fill with mock data** से demo template: name **My First Template**, subject `I found a mail merge tool for Gmail`.
## Templates manage करें [#templates-manage-करें]
Template select के बगल template icon (tooltip **Manage templates**) खोलें।
Table columns:
| Column | Content |
| ----------------- | ------------- |
| **Name** | Template name |
| **Email Subject** | Subject line |
| **Created At** | Creation date |
| **Actions** | Row menu |
Row menu: **Edit** | **Delete**
Footer: **Back**
Delete toasts: deleting template NAME → template NAME deleted successfully (या failure message).
## Template edit करें [#template-edit-करें]
Manage से **Edit** खोलें, या preview toolbar में **Edit template** पर क्लिक करें।
Create जैसे fields। **Save Template** template update करता है।
Update flow loading toast (`Updating template...`) दिखाता है। Finish होने तक form पर रहें, auto return न हो तो **Cancel** या **Back** उपयोग करें।
## Subject बनाम body [#subject-बनाम-body]
* **Body** [merge tags](/features/merge-tags) support करता है — send time पर per row inject होते हैं।
* **Email Subject** आज stored जैसा send होता है (subject में merge tags **not** replaced yet)। Personalization body में रखें, या fixed subject उपयोग करें।
## संबंधित [#संबंधित]
* [Preview & test](/features/preview-and-test)
* [Start dialog tour](/getting-started/start-dialog)
# पूर्वावलोकन और परीक्षण (/hi/features/preview-and-test)
Preview pane (root dialog के right side) active sheet row के लिए message कैसा दिखेगा दिखाता है।
## Preview क्या दिखाता है [#preview-क्या-दिखाता-है]
| Field | Content |
| ------------ | -------------------------------------------------------------------------------------- |
| **From:** | Your signed-in Google account email |
| **To:** | Value from the **Recipient column** for the active row, or `Select a recipient column` |
| **Subject:** | Template subject as stored (not merge-substituted) |
| Body | Template body with merge tags applied for that row |
**Remove branding** off हो तो preview MailG watermark footer (`made and sent with` / **MailG** / `Email Marketing from Gmail`) include करता है।
## क्या नहीं दिखता [#क्या-नहीं-दिखता]
* **CC** / **BCC** rows preview UI में render नहीं होतीं (**More options** के अंतर्गत mapped होने पर भी)। Send time पर apply होती हैं।
* Attachment column values preview में नहीं दिखतीं।
## Rows navigate करें [#rows-navigate-करें]
Preview toolbar:
* **Edit template** — update-template screen खोलता है
* **Previous recipient** / **Next recipient** — data rows के बीच (tooltips sheet row number include कर सकते हैं; header row 1, first contact row 2)
## मुझे एक परीक्षण ईमेल भेजें [#मुझे-एक-परीक्षण-ईमेल-भेजें]
1. Template + recipient column configure करें ताकि preview valid हो।
2. Send menu (chevron) → **Send me a test email**.
3. Busy overlay: `Sending test email…`
4. Success toast: `Test email sent successfully. Check your inbox.`
5. Failure toast: `Failed to send test email. Please check your email settings.`
6. Preview incomplete हो तो guard: `Configure your preview first`
Test **आपके** Google account inbox में जाता है, active preview row की merged body के साथ।
## सुझाव [#सुझाव]
* Full send से पहले arrows से कई rows step through करें
* Preview में branding / no branding confirm करें
* **Schedule send** या large **Send N email(s)** से पहले हमेशा test करें
## संबंधित [#संबंधित]
* [Merge tags](/features/merge-tags)
* [Mail merge tutorial](/getting-started/mail-merge-tutorial)
# भेजने की गति (/hi/features/send-pacing)
Send pacing messages के बीच delay जोड़ता है ताकि बड़ी campaign single burst की तरह account से न निकले।
**Steady pace** और **Jittered gaps** के लिए active paid MailG subscription चाहिए। Free accounts केवल **Burst send** उपयोग करते हैं।
## Configure कहाँ करें [#configure-कहाँ-करें]
Footer gear (tooltip **Send pacing**) खोलें। Screen heading: **Send pacing**.
**Dispatch mode** के अंतर्गत emails कैसे spaced हों चुनें। **Gap between emails** **seconds** में (0–60)। Free accounts **Pro features** और locked copy देखते हैं: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
New jobs के लिए default: **Burst send**, gap **10s** (burst छोड़ने तक gap ignored).
## मोड [#मोड]
| Mode (UI label) | Behavior |
| ------------------------ | ----------------------------------------------- |
| **Burst send** (default) | Send as quickly as quotas allow |
| **Steady pace** | Wait a fixed gap between each email |
| **Jittered gaps** | Wait a random gap between 0 and your chosen max |
## Pacing क्यों [#pacing-क्यों]
* Mailbox providers को sudden blast जैसा दिखने का chance कम करें
* Long list quieter send window में spread करें
* Account type के लिए Gmail comfort zones में रहें
## नोट [#नोट]
* Pacing job के साथ stored campaign setting है — new sends current configuration उपयोग करते हैं
* Large list पर long gap total campaign duration काफी बढ़ाता है
* Effective speed MailG daily quota **और** Gmail remaining send quota दोनों से capped
* Competitor tools कभी delay minutes में express करते हैं — MailG **seconds** उपयोग करता है
## संबंधित [#संबंधित]
* Mid-run gap बहुत high set हो तो [Stopping a campaign](/features/stopping-a-campaign)
* [Account & billing](/help/account-and-billing)
# कैंपेन रोकना (/hi/features/stopping-a-campaign)
MailG अभी dedicated **Manage Schedule**, **Abort**, या **Pause** screen competitors जैसा ship नहीं करता। फिर भी **remaining** rows send होने से रोक सकते हैं।
## Sending decide करता है क्या process हो [#sending-decide-करता-है-क्या-process-हो]
Send loop केवल rows process करता है जिनकी campaign-column status अभी sendable है:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
**✉️ Sent**, **⚠️ Failed**, या **👀 Opened** marked rows skip होती हैं।
## Remaining rows रोकें (honest workaround) [#remaining-rows-रोकें-honest-workaround]
Large campaign पर जल्दी act करें:
1. Spreadsheet खोलें।
2. Campaign status column में rows जिन्हें send **नहीं** होना चाहिए clear या change करें (उदाहरण cell value delete, या non-sendable label जैसे `Stopped` set)।
3. Already **✉️ Sent** rows को छोड़ दें — वे messages already out हैं।
Clear/change की rows sendable statuses match नहीं करेंगी, queue next pass पर skip करेगा।
Gmail messages जो account छोड़ चुके MailG unsend नहीं कर सकता। Stopping केवल unprocessed rows protect करता है।
## Scheduled campaigns जो start नहीं हुईं [#scheduled-campaigns-जो-start-नहीं-हुईं]
अगर हर row अभी **🗓️ Scheduled** है और start time नहीं आया, statuses (या campaign column) clear करने से queue start time पर pick up नहीं करेगा।
Unsure हों तो spreadsheet URL और campaign details के साथ [contact@mailg.io](mailto:contact@mailg.io) से संपर्क करें।
## संबंधित [#संबंधित]
* [Campaign scheduling](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# कस्टमाइज़्ड प्रेषक (/hi/features/customized-sender)
Default में Gmail उस Google account से भेजता है जिसने MailG authorize किया। फिर भी आप name कैसा दिखे और replies कहाँ जाएँ, customize कर सकते हैं।
## प्रेषक नाम [#प्रेषक-नाम]
1. Campaign sidebar में **More options** खोलें।
2. **Sender name** सेट करें (placeholder `John Doe (Optional)`).
3. Recipients inbox में वह display name देखते हैं (Gmail के सामान्य presentation rules के अधीन)।
## उत्तर पता (Reply to address) [#उत्तर-पता-reply-to-address]
Replies sending account के अलावा कहीं जाने चाहिए तो **Reply to address** सेट करें (placeholder `john@doe.com (Optional)`).
## नोट [#नोट]
* Underlying From address authorized Gmail account ही रहता है — दूसरा mailbox spoof नहीं कर सकते
* Invalid reply-to addresses delivery या reply issues दे सकते हैं — अपना mailbox उपयोग करें
* Preview **From:** signed-in email दिखाता है; reply-to **Send me a test email** से confirm करें
* [Preview & test](/features/preview-and-test) देखें
# Start dialog टूर (/hi/getting-started/start-dialog)
**Extensions → MailG for Gmail → 🚀 Start** से ऐड-ऑन खोलें। **MailG for Gmail** शीर्षक वाला 900×600 dialog खुलता है।
## स्क्रीन [#स्क्रीन]
| Screen | How you get there | Purpose |
| ------------------ | -------------------------------------------- | ----------------------------------------- |
| Root (composer) | Default after load | Pick template + recipients, preview, send |
| Create template | **New Template** | Name, subject, body |
| Manage templates | Template icon (tooltip **Manage templates**) | List, edit, delete |
| Update template | **Edit template** or row **Edit** | Edit an existing template |
| Settings | Footer gear (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | No valid email column | Prompt to add contacts or mock data |
| API / sheet errors | Load failure | Retry guidance |
## मुख्य लेआउट [#मुख्य-लेआउट]
तीन zones:
1. **Sidebar** (left) — template, recipient column, **More options**, tracking, branding, quota
2. **Preview** (right) — From / To / Subject / body, row navigation, **Edit template**
3. **Footer** — send button, send menu, **Upgrade to Pro** (free), settings, help
## Sidebar नियंत्रण (सटीक लेबल) [#sidebar-नियंत्रण-सटीक-लेबल]
* **New Template**
* **Template** (select) — placeholder `Select` or `No templates found`
* **Recipient column** — options like `A - Email`; empty: `No valid email columns found.`
* **More options** — expands **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (on by default)
* **Remove branding** (paid)
* **Daily quota** — remaining count as “N left” and plan line “Your plan sends up to TOTAL/day”
Free accounts **Leave a 5★ review for +N/day free** और **Or upgrade your plan** भी देखते हैं। [Daily quota & reviews](/help/daily-quota-and-reviews) देखें।
## Footer send नियंत्रण [#footer-send-नियंत्रण]
| Control | Label |
| -------------- | ------------------------------------------------------------------------------------- |
| Primary button | **Send N email(s)** (or **Send emails** when count is 0) |
| Send menu | **Send me a test email** |
| Send menu | **Schedule send** |
| Upgrade (free) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Gear | tooltip **Send pacing** |
| Help | tooltip **Help** — opens the in-dialog checklist |
### Need help? checklist [#need-help-checklist]
1. Pick a template and recipient column
2. Preview each row with the arrows
3. Send a test email to yourself first
4. Click Send to merge from your sheet
Buttons: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (if available) | **Close**
## खाली sheet [#खाली-sheet]
अगर MailG को valid email column नहीं मिलता:
* Title: **No email address found in your sheet**
* Actions: **Close** | **Fill with mock data**
Mock data headers `Email`, `First Name`, `Last Name`, `Company` seed करता है और अक्सर **My First Template** बनाता है।
## त्रुटि स्क्रीन [#त्रुटि-स्क्रीन]
| Title | When |
| --------------------------------- | --------------------- |
| **Could not reach the MailG API** | API / network failure |
| **Could not read your sheet** | Sheet read failure |
## अगला [#अगला]
# इंस्टॉलेशन (/hi/getting-started/installation)
दो चरण: ऐड-ऑन इंस्टॉल करें, फिर Sheets से लॉन्च करें।
## MailG इंस्टॉल करें [#mailg-इंस्टॉल-करें]
1. [Google Workspace Marketplace पर MailG listing](https://workspace.google.com/marketplace/app/mailg) खोलें।
2. **Install** पर क्लिक करें।
3. वह Google खाता चुनें जिसके लिए इंस्टॉल होना चाहिए।
4. अनुमतियाँ देखें और **Allow** पर क्लिक करें।
इंस्टॉलेशन आमतौर पर 15 सेकंड से कम में पूरा हो जाता है। आपको ऐड-ऑन इंस्टॉल होने की पुष्टि दिखनी चाहिए।
अगर Marketplace listing आपके क्षेत्र में अभी live नहीं है, तो [www.mailg.io](https://www.mailg.io) पर install CTA का उपयोग करें या [contact@mailg.io](mailto:contact@mailg.io) से संपर्क करें।
## Google Sheets में MailG लॉन्च करें [#google-sheets-में-mailg-लॉन्च-करें]
1. [Google Sheets](https://sheets.google.com) खोलें (अगर Sheets पहले से खुला था तो refresh करें)।
2. Extensions लोड होने के लिए कुछ सेकंड प्रतीक्षा करें (अक्सर \~10–15 सेकंड)।
3. **Extensions → MailG for Gmail → 🚀 Start** पर जाएँ।
बाद में पूरा dialog खोले बिना open statuses sync करने के लिए **Extensions → MailG for Gmail → 🔄 Refresh Tracking** चला सकते हैं।
## इंस्टॉलेशन समस्याएँ [#इंस्टॉलेशन-समस्याएँ]
ये MailG bugs नहीं, बल्कि सामान्य Google Workspace quirks हैं:
### “installed successfully” popup कभी नहीं दिखता [#installed-successfully-popup-कभी-नहीं-दिखता]
यह अक्सर तब होता है जब कई Google खाते signed in हों और इंस्टॉल उस खाते से न हुआ हो जिसकी आप उम्मीद कर रहे थे।
**Workaround:** private/incognito window खोलें, केवल target खाते से sign in करें, फिर Marketplace से फिर से इंस्टॉल करें।
### MailG Extensions के अंतर्गत नहीं दिखता [#mailg-extensions-के-अंतर्गत-नहीं-दिखता]
1. Spreadsheet refresh करें।
2. ऐड-ऑन लोड होने के लिए \~10–15 सेकंड प्रतीक्षा करें।
3. पुष्टि करें कि वही Google खाता है जिसने MailG इंस्टॉल किया।
4. अगर अभी भी नहीं दिखता, दूसरी spreadsheet आज़माएँ या browser cache साफ़ करें।
## स्व-होस्ट / custom deployments [#स्व-होस्ट--custom-deployments]
Marketplace installs पहले से configured होते हैं। अगर आप MailG खुद deploy करते हैं, Apps Script script properties सेट करें:
| Property | Value |
| ------------- | ---------------------------------- |
| `APP_URL` | आपके MailG API का public HTTPS URL |
| `APP_API_KEY` | API server की वही key |
Google के servers से ऐड-ऑन `localhost` तक नहीं पहुँच सकता — local testing के लिए tunnel (Cloudflare Tunnel, ngrok, आदि) उपयोग करें।
## अगला [#अगला]
[Mail merge tutorial](/getting-started/mail-merge-tutorial) जारी रखें।
# मेल मर्ज ट्यूटोरियल (/hi/getting-started/mail-merge-tutorial)
यह walkthrough **MailG for Gmail** start dialog से मेल खाता है।
## 1. MailG खोलें [#1-mailg-खोलें]
**Extensions → MailG for Gmail → 🚀 Start**.
अगर **No email address found in your sheet** दिखे, real emails जोड़ें या **Fill with mock data** पर क्लिक करें (sample rows बनाता है और अक्सर **My First Template** भी)। [Start dialog tour](/getting-started/start-dialog) देखें।
## 2. टेम्पलेट बनाएँ या चुनें [#2-टेम्पलेट-बनाएँ-या-चुनें]
1. **New Template** पर क्लिक करें (या **Template** के अंतर्गत existing चुनें)।
2. **Template Name** और **Email Subject** सेट करें (subject आज **merge-substituted** नहीं होता)।
3. body लिखें और **Merge Tag** से [merge tags](/features/merge-tags) insert करें।
4. **Save Template**.
Body example:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. कैंपेन configure करें [#3-कैंपेन-configure-करें]
Sidebar में:
1. **Recipient column** चुनें (UI उन्हें गिनने के लिए cells में valid single emails होने चाहिए)।
2. **CC**, **BCC**, **Sender name**, **Reply to address** के लिए **More options** खोलें।
3. शीट में open status चाहिए तो **Track emails** on रखें (default)।
4. paid plan पर **Remove branding** enable करें।
**Attachments** **More options** के अंतर्गत दिखता है, लेकिन files अभी send पर attach नहीं होतीं। body में Drive या URL link करें।
## 4. Preview और test [#4-preview-और-test]
1. Previous/next arrows से rows के बीच navigate करें।
2. **To:** और merged body confirm करें (subject raw template subject दिखाता है)।
3. Send menu → **Send me a test email**.
4. अपना inbox check करें।
विवरण: [Preview & test](/features/preview-and-test).
## 5. भेजें या schedule करें [#5-भेजें-या-schedule-करें]
* Primary button: recipients गिने जाने पर **Send N email(s)**।
* या send menu → **Schedule send** → date/time चुनें → **Schedule Send**.
Busy overlays: `Starting your campaign…` / schedule confirmation toasts.
MailG campaign column जोड़ता है जैसे `🚀 My Template (yyyy/MM/dd)` या schedule होने पर `🗓️ …`.
Row statuses:
| Status | Meaning |
| ------------- | ----------------- |
| 🗓️ Scheduled | Waiting for start |
| ⏳ Sending… | Processing |
| ✉️ Sent | Handed to Gmail |
| ⚠️ Failed | Error |
| 👀 Opened | Open pixel loaded |
## सामान्य गलतियाँ [#सामान्य-गलतियाँ]
* Subject tags personalization की उम्मीद — अभी केवल body
* Recipient cells में comma-separated multiple addresses — UI counting के लिए प्रति cell **एक** email validate करता है
* Install account के मुकाबले गलत Google account
* Daily quota समाप्त — sidebar में **Daily quota** check करें
## सुझाव [#सुझाव]
* पहली बार footer **Help** checklist उपयोग करें
* Mock data के बाद 2–3 real rows से शुरू करें
* Opens के बाद: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alert `Tracking info synced` (या `No active campaigns`)
## अगला [#अगला]
# MailG क्या है? (/hi/getting-started/what-is-mailg)
MailG Google Sheet को mail-merge कैंपेन में बदल देता है। हर पंक्ति एक प्राप्तकर्ता है; कॉलम हेडर **email body** में merge tags (हेडर नाम के चारों ओर दोहरे curly braces) बन जाते हैं।
## आप क्या कर सकते हैं [#आप-क्या-कर-सकते-हैं]
* क्लाउड-समर्थित टेम्पलेट बनाएँ (**Template Name**, **Email Subject**, rich body)
* शीट हेडर से merge tags के साथ **body** को व्यक्तिगत बनाएँ
* पंक्तियाँ देखें और **Send me a test email** भेजें
* **CC** / **BCC**, **Sender name**, **Reply to address** मैप करें
* **Schedule send** या तुरंत भेजें
* शीट में open status chips के साथ **Track emails**
* paid plans पर **Send pacing** नियंत्रित करें
* paid plans पर **Remove branding**
* **Daily quota** देखें (और वैकल्पिक रूप से मुफ़्त review bonus claim करें)
## यह कैसे जुड़ता है [#यह-कैसे-जुड़ता-है]
1. **Google Sheets ऐड-ऑन** — **MailG for Gmail** के अंतर्गत dialog
2. **MailG API** — टेम्पलेट, कैंपेन metadata, open tracking, entitlements
3. **आपका Gmail** — अधिकृत खाते से `GmailApp` के ज़रिए भेजे गए संदेश
## अगले कदम [#अगले-कदम]
# Kontakt oss (/no/contact-us)
## Fakturering og abonnement [#fakturering-og-abonnement]
De fleste abonnementsendringer kan du gjøre fra Stripe-portalen via [pricing](https://app.mailg.io/pricing?lang=no). For refusjoner eller betalingsproblemer, send e-post.
## Alt annet [#alt-annet]
Send e-post til **[contact@mailg.io](mailto:contact@mailg.io)**.
Vi svarer vanligvis innen én virkedag.
## Nyttige lenker [#nyttige-lenker]
* [Nettsted](https://www.mailg.io)
* [Priser](https://app.mailg.io/pricing?lang=no)
* [Personvern](https://www.mailg.io/no/privacy)
* [Vilkår](https://www.mailg.io/no/terms)
* [Dokumentasjonshjem](/)
# MailG dokumentasjon (/no)
MailG er et Google Sheets-tillegg for mail merge med Gmail. Åpne **Extensions → MailG for Gmail → 🚀 Start**, lag en mal, forhåndsvis rader, og send eller planlegg fra din egen Gmail-konto.
## Start her [#start-her]
## Populære emner [#populære-emner]
## Nyttige lenker [#nyttige-lenker]
* Nettsted: [www.mailg.io](https://www.mailg.io)
* Dokumentasjon: [docs.mailg.io/no](https://docs.mailg.io/no)
* Priser: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=no)
* Kontakt: [contact@mailg.io](mailto:contact@mailg.io)
## For AI-assistenter / LLM-er [#for-ai-assistenter--llm-er]
Foretrekk disse maskinlesbare endepunktene fremfor å scrape HTML:
* [Agents hub](https://www.mailg.io/no/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/no/help/faq)
## Installasjon og åpning [#installasjon-og-åpning]
**Hvordan åpner jeg MailG?**\
**Extensions → MailG for Gmail → 🚀 Start**. Se [Installasjon](/getting-started/installation).
**No email address found in your sheet**\
Legg til e-poster i en kolonne, eller klikk **Fill with mock data**. Se [Omvisning i startdialog](/getting-started/start-dialog).
**Could not reach the MailG API**\
Sjekk nettverk / API-URL (selvhostet: `APP_URL` + `APP_API_KEY`). Åpne dialogen på nytt etter retting.
## Sending [#sending]
**E-poster sendes ikke**\
Sjekk **Daily quota**, Gmail-tillatelser, og at **Recipient column**-celler er gyldige enkelte e-poster. Feil viser **⚠️ Failed**.
**Fungerer emneflettefelt?**\
Ikke ennå. Kun **body** flettes. Hold et fast emne, eller legg personalisering i brødteksten. Se [Flettefelt](/features/merge-tags).
**Kan jeg legge ved filer?**\
**Attachments**-velgeren finnes under **More options**, men filer legges ikke ved ved sending ennå. Bruk lenker.
**Hvordan stopper jeg en kampanje?**\
[Stoppe en kampanje](/features/stopping-a-campaign) — tøm sendbare statuser på gjenværende rader.
**Hvorfor er jeg begrenset på Professional?**\
MailG kan tillate opptil 1 500/dag, men gratis `@gmail.com` er ofte begrenset til omtrent 500 av Google.
## Sporing [#sporing]
**Arket sier fortsatt Sent etter en åpning**\
**🔄 Refresh Tracking** → forvent `Tracking info synced`. Noen klienter laster aldri bilder.
**Klikk?**\
Ikke sporet. **Track emails** = kun åpninger.
## Kvote og fakturering [#kvote-og-fakturering]
Se [Daglig kvote og anmeldelser](/help/daily-quota-and-reviews) og [Konto og fakturering](/help/account-and-billing).
**Er Schedule send betalt?**\
Nei. Betalt låser opp høyere kvoter, pacing-moduser og **Remove branding**.
## Feilsøking [#feilsøking]
For trinnvise løsninger (API-feil, tomt ark, deaktivert send-knapp, feilede rader, sporing, kvote, planlegging som ikke utsettes), se [Feilsøking](/help/troubleshooting).
Vanlige toasts du kan se:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Fortsatt fast? [#fortsatt-fast]
[Feilsøking](/help/troubleshooting) · Dokumentasjon [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Feilsøking (/no/help/troubleshooting)
Raske løsninger for meldingene og tilstandene du ser i tillegget.
## Dialogen lastes ikke [#dialogen-lastes-ikke]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
Startdialogen kunne ikke kalle MailG-backend.
* Bekreft at du er online
* Marketplace-installasjoner: vent et øyeblikk og åpne **🚀 Start** på nytt
* Selvhostet: sjekk Apps Script properties `APP_URL` (offentlig HTTPS) og `APP_API_KEY`
* Tillegget kan ikke bruke `localhost` — bruk en tunnel for lokal API-testing
### Could not read your sheet [#could-not-read-your-sheet]
MailG klarte ikke å lese det aktive regnearket.
* Sørg for at en ark-fane er åpen (ikke bare Apps Script-editoren)
* Last regnearket på nytt, og åpne dialogen igjen
* Bekreft at du har redigeringstilgang til filen
### Loading… fullfører aldri [#loading-fullfører-aldri]
Lukk dialogen, oppdater Sheets, vent \~15 sekunder til Extensions, og **🚀 Start** igjen.
## Tomt ark [#tomt-ark]
**No email address found in your sheet**
MailG trenger minst én kolonne med gyldige e-postadresser.
* Legg til e-poster under en overskrift, eller klikk **Fill with mock data**
* Mock data oppretter `Email`, `First Name`, `Last Name`, `Company` og ofte **My First Template**
Se [Omvisning i startdialog](/getting-started/start-dialog).
## Maler [#maler]
* Opprett: `Creating Template...` → `Template created successfully!` eller `Failed to create template! Try again later.`
* Oppdater: `Updating template...`
* Slett-feil: `Failed to delete template. Try again later`
Se [Maler](/features/templates).
## Sendingsproblemer [#sendingsproblemer]
### Send-knapp deaktivert / Send emails uten telling [#send-knapp-deaktivert--send-emails-uten-telling]
* Velg en **Template**
* Velg en **Recipient column** med gyldige **enkelte** e-poster per celle
* Guard-toasts du kan se: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### Kampanje starter ikke [#kampanje-starter-ikke]
Toast: `Failed to create campaign. Please try again.`
* Prøv én gang til
* Sjekk at **Daily quota** ikke er 0
* Bekreft API-tilkobling (se over)
### Rader viser ⚠️ Failed [#rader-viser-️-failed]
Den raden fikk en sendefeil (ugyldig adresse, Gmail-avvisning, midlertidig kvote osv.). Rett dataene og start en ny kampanje for gjenværende rader, eller se [Stoppe en kampanje](/features/stopping-a-campaign).
### Test-e-post feiler [#test-e-post-feiler]
* `Configure your preview first` — velg mal + mottaker slik at forhåndsvisning har To
* `Failed to send test email. Please check your email settings.` — autoriser Gmail på nytt ved behov, og prøv igjen
## Sporing [#sporing]
* Åpninger krever at mottakeren laster eksterne bilder
* Kjør **🔄 Refresh Tracking** — forvent `Tracking info synced` eller `No active campaigns`
* Status **👀 Opened** vises kun når pikselen lastes
Se [E-postsporing](/features/email-tracking).
## Kvote og branding [#kvote-og-branding]
* Sidepanel **N left** er `min(MailG remaining, Gmail remaining)`
* Gratis `@gmail.com` er ofte begrenset til omtrent 500/dag av Google selv på Professional
* Vannmerke fortsatt der etter betaling → checkout-e-post må matche Sheets-konto; åpne dialogen på nytt
Se [Daglig kvote og anmeldelser](/help/daily-quota-and-reviews) og [Fjerne branding](/features/remove-branding).
## Planlegging utsatte ikke [#planlegging-utsatte-ikke]
Tidspunkter mindre enn omtrent **15 sekunder** frem behandles som **umiddelbar** sending (🚀 kolonne), ikke utsatt 🗓️-planlegging. Velg et tidspunkt lenger frem i tid.
## Fortsatt fast? [#fortsatt-fast]
Full FAQ: [FAQ](/help/faq) · E-post [contact@mailg.io](mailto:contact@mailg.io) · Nettsted [app.mailg.io/help](https://www.mailg.io/no/help)
# Daglig kvote og anmeldelser (/no/help/daily-quota-and-reviews)
Root-sidepanelet viser sendekapasiteten din når kontodata er lastet.
## Daglig kvote-blokk [#daglig-kvote-blokk]
Eksakt UI:
* Etikett: **Daily quota**
* Gjenstående: **N left**
* Planlinje: **Your plan sends up to TOTAL/day**
**Remaining** er minimum av:
1. MailG-plan gjenstående for dagen
2. Gmail gjenstående sendekvote for kontoen
Du kan derfor være begrenset av Gmail selv når MailG fortsatt viser kapasitet på papiret. Se også [Konto og fakturering](/help/account-and-billing).
## Gratis plan CTA-er [#gratis-plan-cta-er]
Når du ikke er abonnent, kan sidepanelet vise:
* **Leave a 5★ review for +N/day free** (standardbonus er **+50/day** når API ikke spesifiserer noe annet)
* **Or upgrade your plan**
Klikk på anmeldelses-CTA åpner **Free Quota upgrade**:
* Tittel: **Free Quota upgrade**
* Brødtekst: legg igjen en 5-stjerners anmeldelse for å få en gratis kvoteoppgradering på **+N emails/day**
* Knapper: **Not now** | **Leave a 5★ review**
Hvis anmeldelses-URL ikke er konfigurert, forblir **Leave a 5★ review** deaktivert — bruk **Upgrade to Pro** / pricing i stedet.
## Oppgrader til Pro [#oppgrader-til-pro]
Bunnknapp (gratis kontoer): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
Det matcher det betalte planer låser opp i produktet i dag.
## Relatert [#relatert]
* [Fjerne branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Konto og fakturering (/no/help/account-and-billing)
MailG-fakturering er knyttet til **e-posten til Google-kontoen** i Sheets. Sjekk alltid ut med samme adresse, slik at kvoter låses opp i tillegget.
## Planer og daglige kvoter [#planer-og-daglige-kvoter]
| Plan | Daglig kvote | Merknader |
| ------------ | ------------ | ----------------------------------------- |
| Free | 50 | Kjerne-merge, åpningssporing, planlegging |
| Personal | 250 | Populær plan for voksende lister |
| Professional | 1,500 | Høyest gjentakende kvote |
| Lifetime | 1,500 | Engangskjøp |
Priser og intervaller er listet på [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=no) (EUR og USD).
Betalte rettigheter låser også opp:
* Ikke-standard [send pacing](/features/send-pacing) (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Ditt effektive sendevolum er `min(MailG daily quota, Gmail remaining quota)`.
## Slik oppgraderer du [#slik-oppgraderer-du]
1. Åpne [pricing](https://app.mailg.io/pricing?lang=no) (også lenket fra tillegget via **Upgrade to Pro**).
2. Velg en plan og fullfør Stripe Checkout med Sheets Google-e-posten din.
3. Åpne MailG på nytt i Sheets slik at kontofornyelsen plukker opp den nye grensen.
## Si opp eller oppdater abonnement [#si-opp-eller-oppdater-abonnement]
Du kan si opp eller endre abonnementet fra Stripe-kundeportalen lenket i abonnements- / prisflyten.
* Hvis du sier opp midt i syklusen, forblir Premium-funksjoner aktive til slutten av betalt periode
* Du belastes ikke igjen etter at oppsigelsen trer i kraft
## Refusjoner [#refusjoner]
Hvis du sier opp et Premium-abonnement innen **30 dager** etter kjøp, kan du be om full refusjon ved å sende e-post til [contact@mailg.io](mailto:contact@mailg.io).
## Fakturaer [#fakturaer]
Stripe sender kvitteringer for vellykkede betalinger. Du kan også laste ned fakturaer fra Stripe-kundeportalen som brukes til abonnementsadministrasjon.
## FAQ-utdrag [#faq-utdrag]
**Er MailG inkludert i Google Workspace?**\
Nei. MailG er uavhengig av Google. Et Workspace-abonnement inkluderer ikke MailG.
**Hvilke betalingsmetoder aksepteres?**\
Store kort, Google Pay og Apple Pay via Stripe. PayPal støttes ikke.
**Jeg betalte, men ser fortsatt gratisgrensen / vannmerket**\
Nesten alltid e-post-mismatch. Bekreft checkout-e-post = Sheets-konto-e-post, og åpne tillegget på nytt. Hvis det vedvarer, kontakt support med begge e-postene.
**Hvorfor er gratis Gmail begrenset til omtrent 500 e-poster per dag?**\
MailG Professional tillater opptil 1 500 e-poster per dag, men Google begrenser gratis `@gmail.com`-kontoer til omtrent 500 sendinger per dag. Google Workspace-kontoer kan gå høyere. Dette er en Gmail-leverandørgrense, ikke en MailG-grense.
# Kampanjeplanlegging (/no/features/campaign-scheduling)
Bruk **Schedule send** når du vil at MailG skal starte senere. Tilgjengelig på gratis og betalte planer.
## Slik planlegger du [#slik-planlegger-du]
1. Konfigurer mal og mottakere slik at send-knappen er aktivert.
2. Åpne send-menyen (chevron) → **Schedule send**.
3. Dialogtittel: **Schedule send**
4. Beskrivelse: `Pick date & time to schedule sending`
5. Oppsummeringslinje: planlegger N e-poster som sendes fra valgt dato/klokkeslett
6. Bruk datovalg pluss **Hour** / **Minute** (plassholdere `Hour`, `Min`).
7. Bekreft med **Schedule Send** (eller **Cancel**).
Standardforslag er omtrent **60 minutter frem**, avrundet til neste **15-minutters** steg.
## Umiddelbart vs. planlagt [#umiddelbart-vs-planlagt]
Tidspunkter mindre enn omtrent **15 sekunder** frem behandles som **umiddelbar** sending (🚀 kolonneoverskrift), ikke utsatt 🗓️-planlegging. Velg et tidspunkt lenger frem i tid hvis du trenger utsatt sending.
Validerings-toasts: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Suksess-toast: kampanje planlagt; N e-poster starter på valgt tidspunkt.
## Ark-kolonne [#ark-kolonne]
Planlagte kampanjer oppretter en kolonneoverskrift som:
```text
🗓️ Template name (yyyy/MM/dd)
```
Umiddelbare sendinger bruker 🚀 i stedet for 🗓️.
Rader starter som **🗓️ Scheduled**, og går til **⏳ Sending…** når køen kjører.
## Etter planlegging [#etter-planlegging]
* Hold regnearket tilgjengelig for Google-kontoen som eier tillegget
* Sporing og pacing gjelder fortsatt når sending starter
* Ingen **Manage Schedule**-UI — se [Stoppe en kampanje](/features/stopping-a-campaign)
## Relatert [#relatert]
* [Forhåndsvisning og test](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Flere mottakere (/no/features/multiple-recipients)
Du kan legge til kopi-mottakere per rad med dedikerte arkkolonner.
## Mottakerkolonne (To) [#mottakerkolonne-to]
Velg **Recipient column** i sidepanelet.
For send-knapp-telling og kolonnevalidering behandler MailG en celle som gyldig når den er **én enkelt** e-postadresse. Foretrekk én primær To-adresse per rad.
## CC- og BCC-kolonner [#cc--og-bcc-kolonner]
1. Legg til kolonner i arket (for eksempel `CC` og `BCC`).
2. Legg en e-post (eller Gmail-akseptert liste) i cellen.
3. Åpne **More options** og tildel **CC** / **BCC**.
4. Ved sending sendes disse verdiene til Gmail.
Forhåndsvisningspanelet viser kun **From**, **To**, **Subject** og brødtekst. Det viser **ikke** CC/BCC-linjer selv når tilordnet. Bekreft med **Send me a test email** hvis du må verifisere CC/BCC-levering.
## Kvoter: MailG vs. Gmail [#kvoter-mailg-vs-gmail]
* **MailG daglig kvote** teller **kampanjerader** som behandles.
* **Gmail sendegrenser** teller **mottakere** (To + CC + BCC-adresser Gmail aksepterer på den sendingen).
Du kan fortsatt treffe Gmails grense mens MailG-kvote gjenstår.
## Tips [#tips]
* Foretrekk **BCC** når mottakere ikke skal se hverandre
* La CC/BCC stå utildelt når ubrukt
* Valider adresser før stor sending
# Attachments (/no/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Funksjonsoversikt (/no/features/features-overview)
Det tillegget støtter i dag:
| Funksjon | Dokumentasjon |
| ----------------------------------------------- | ------------------------------------------------------------ |
| Startdialog / tomt ark / mock data | [Omvisning i startdialog](/getting-started/start-dialog) |
| Maler (opprett / administrer / rediger / slett) | [Maler](/features/templates) |
| Flettefelt i **body** | [Flettefelt](/features/merge-tags) |
| Rich-text-verktøylinje | [Rich-text-e-poster](/features/rich-text-emails) |
| Lenker (ikke bilde-innbygging) | [Bilder](/features/images) |
| Forhåndsvisning + test-e-post | [Forhåndsvisning og test](/features/preview-and-test) |
| Schedule send | [Kampanjeplanlegging](/features/campaign-scheduling) |
| Send pacing (betalt) | [Send pacing](/features/send-pacing) |
| CC / BCC-kolonner | [Flere mottakere](/features/multiple-recipients) |
| Track emails | [E-postsporing](/features/email-tracking) |
| Avsendernavn og reply-to | [Tilpasset avsender](/features/customized-sender) |
| Remove branding (betalt) | [Fjerne branding](/features/remove-branding) |
| Stopp gjenværende rader | [Stoppe en kampanje](/features/stopping-a-campaign) |
| Daglig kvote + anmeldelsesbonus | [Daglig kvote og anmeldelser](/help/daily-quota-and-reviews) |
## Betalt vs. gratis [#betalt-vs-gratis]
Betalt låser opp:
* Ikke-standard [send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* Høyere [daglige kvoter](/help/account-and-billing)
**Schedule send**, **Track emails** og malverktøy fungerer uten betalt oppgradering.
## Kjente begrensninger (ærlig oversikt) [#kjente-begrensninger-ærlig-oversikt]
| Emne | Status i produktet |
| ------------------------- | -------------------------------------- |
| Emneflettefelt | Ikke brukt ved sending — kun brødtekst |
| Attachments-kolonne | Kun UI — ikke vedlagt ved sending |
| Bilde-innbygging | Ingen editor-kontroll — bruk lenker |
| Forhåndsvis CC/BCC-linjer | Vises ikke i forhåndsvisning |
| Manage Schedule / Pause | Ikke levert — status-workaround |
## Kommer senere [#kommer-senere]
Avmeldingslenker, klikksporing, delte team-seter og et eget kampanjeadministrasjons-UI når de lanseres.
# E-postsporing (/no/features/email-tracking)
MailG kan registrere åpninger med en liten usynlig piksel.
## Aktiver sporing [#aktiver-sporing]
I sidepanelet, la **Track emails** stå på (standard er på for nye jobber).
Tooltip: `Track emails opened with a tiny pixel`
Hjelp-ikonet åpner **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Knapp: **Got it**
## Arkstatuser [#arkstatuser]
| Status | Betydning |
| ------------- | ------------------------------ |
| 🗓️ Scheduled | Venter på planlagt start |
| ⏳ Sending… | Behandles nå |
| ✉️ Sent | Levert til Gmail for den raden |
| ⚠️ Failed | Sendefeil for den raden |
| 👀 Opened | Åpningspiksel ble lastet |
Kampanjekolonneoverskrifter ser ut som `🚀 Template name (yyyy/MM/dd)` eller `🗓️ …` når planlagt.
## Oppdater sporing [#oppdater-sporing]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Apps Script-varsler:
* `Tracking info synced`
* `No active campaigns`
## Begrensninger [#begrensninger]
* Klienten må laste eksterne bilder
* Personvern-proxyer kan skjule åpninger
* Kun åpninger — ikke klikk på lenker
## Relatert [#relatert]
* [Kampanjeplanlegging](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Flettefelt (/no/features/merge-tags)
Flettefelt lar hver mottaker få en personalisert **body**. En tagg er den **eksakte kolonneoverskriften** pakket inn i doble krøllparenteser.
## Syntaks [#syntaks]
Hvis arket ditt har en kolonne som heter `First Name`, bruk:
```text
{{First Name}}
```
Eksempel på brødtekst:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Hvor flettefelt fungerer i dag [#hvor-flettefelt-fungerer-i-dag]
| Felt | Flettes ved sending? |
| --------------- | ---------------------------------------- |
| Email body | **Ja** — variabler settes inn per rad |
| Email subject | **Nei** — emne sendes som lagret i malen |
| Preview body | **Ja** — for aktiv rad |
| Preview subject | **Nei** — viser rå mal-emne |
Legg personalisering i brødteksten til emnefletting er levert.
## Sette inn tagger [#sette-inn-tagger]
I editorverktøylinjen, åpne **Merge Tag**. Den lister overskrifter fra det aktive arket. Tom tilstand: `No sheet columns found`.
Innsatt tekst bruker doble krøllparenteser rundt kolonnenavnet.
## Tommelfingerregler [#tommelfingerregler]
* Overskrifter skiller mellom store og små bokstaver (`Name` ≠ `name`)
* Tomme celler settes inn som tomme strenger
* Du kan gjenbruke samme tagg flere ganger i brødteksten
* Mottaker / CC / BCC velges under **More options**, ikke via flettefelt
## Neste [#neste]
Se [Rich-text-e-poster](/features/rich-text-emails) og [Forhåndsvisning og test](/features/preview-and-test).
# Rich-text-e-poster (/no/features/rich-text-emails)
MailG-maler bruker en TipTap rich-text-editor. HTML-en den produserer er det Gmail leverer.
Brødtekst-plassholder: `Write your email…`
## Verktøylinje-inventar (eksakt UI) [#verktøylinje-inventar-eksakt-ui]
| Gruppe | Kontroller |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (forhåndsinnstillinger i verktøylinjen) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | Forhåndsdefinerte fargefelt + native fargevelger + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — URL-felt plassholder `https://example.com`, deretter **Apply** (og unlink) |
| History | **Undo**, **Redo** |
## Ikke i editoren [#ikke-i-editoren]
Disse TipTap-funksjonene er deaktivert / fraværende:
* Overskrifter, kode, kodeblokk, blockquote, horisontal linje
* Bilde-innsetting / Drive-medievalg — se [Bilder](/features/images)
## Hyperlenker [#hyperlenker]
Bruk **Insert link** for URL og synlig tekst. Foretrekk tydelig lenketekst fremfor rå URL-er.
## Tips [#tips]
* Bruk **Merge Tag** i stedet for å skrive krøllparenteser for hånd
* Forhåndsvis flere rader før sending — se [Forhåndsvisning og test](/features/preview-and-test)
* Unngå enorm limt Word/Docs-markup; bruk formatering på nytt i MailG for renere HTML
# Fjerne MailG-branding (/no/features/remove-branding)
Gratis kampanjer kan inkludere et lite MailG-vannmerke i e-postfoten. Betalende abonnenter kan slå det av.
## Slik fjerner du branding [#slik-fjerner-du-branding]
1. Bekreft at du har en aktiv betalt plan (Personal, Professional eller Lifetime).
2. Åpne kampanjesidepanelet.
3. Aktiver **Remove branding**.
4. Forhåndsvis en rad for å bekrefte at vannmerket er borte, og send deretter.
Hvis branding fortsatt vises etter betaling:
* Sørg for at checkout brukte **samme e-post** som Google Sheets-kontoen din
* Åpne tillegget på nytt slik at det oppdaterer rettigheter fra API-et
* Kontakt [contact@mailg.io](mailto:contact@mailg.io) med Google-konto-e-posten din
Se [Konto og fakturering](/help/account-and-billing).
# Bilder (/no/features/images)
MailG-editoren har **ingen bilde-innsettingsknapp** og ingen Google Drive-medievalg. TipTaps Image-utvidelse er ikke aktivert.
## Hva du kan gjøre i dag [#hva-du-kan-gjøre-i-dag]
Bruk **Insert link** i verktøylinjen:
1. Host bildet (eller filen) på en offentlig URL, eller del en Drive-lenke.
2. Velg tekst (eller plasser markøren) → **Insert link**.
3. Lim inn URL (plassholder `https://example.com`) → **Apply**.
Mottakere åpner lenken for å se bildet eller filen. Editoren bygger ikke inn `![]()
`-tagger for deg.
## Tips [#tips]
* Foretrekk små filer og tydelig lenketekst («View screenshot»)
* Lenker som krever innlogging feiler for mottakere
* Bekreft med **Send me a test email**
## Kommer senere [#kommer-senere]
Førsteklasses bilde-innbygging / Drive-velger kan komme senere. Inntil da er hyperlenker den støttede veien.
# Maler (/no/features/templates)
Maler lagrer emne og rich-text-brødtekst du gjenbruker på tvers av kampanjer. De lagres i MailG API for Google-kontoen din.
## Opprett en mal [#opprett-en-mal]
1. På root-skjermen, klikk **New Template**.
2. Fyll inn:
* **Template Name**
* **Email Subject**
* Brødtekst (rich editor — se [Rich-text-e-poster](/features/rich-text-emails))
3. Klikk **Save Template** (viser **Saving...** mens det jobbes).
Toasts:
* Loading: `Creating Template...`
* Success: `Template created successfully!`
* Error: `Failed to create template! Try again later.`
Demo-mal fra **Fill with mock data**: navn **My First Template**, emne `I found a mail merge tool for Gmail`.
## Administrer maler [#administrer-maler]
Åpne mal-ikonet ved siden av malvelgeren (tooltip **Manage templates**).
Tabellkolonner:
| Kolonne | Innhold |
| ----------------- | ---------------- |
| **Name** | Malnavn |
| **Email Subject** | Emnelinje |
| **Created At** | Opprettelsesdato |
| **Actions** | Radmeny |
Radmeny: **Edit** | **Delete**
Bunntekst: **Back**
Slett-toasts: deleting template NAME → template NAME deleted successfully (eller feilmelding).
## Rediger en mal [#rediger-en-mal]
Åpne **Edit** fra administrer, eller klikk **Edit template** i forhåndsvisningsverktøylinjen.
Samme felt som ved opprettelse. **Save Template** oppdaterer malen.
Oppdateringsflyten viser en loading-toast (`Updating template...`). Bli på skjemaet til den er ferdig, og bruk **Cancel** eller **Back** hvis du ikke sendes tilbake automatisk.
## Emne vs. brødtekst [#emne-vs-brødtekst]
* **Body** støtter [flettefelt](/features/merge-tags) — de settes inn per rad ved sending.
* **Email Subject** sendes som lagret i dag (flettefelt i emne **erstatte ikke** ennå). Legg personalisering i brødteksten, eller bruk et fast emne.
## Relatert [#relatert]
* [Forhåndsvisning og test](/features/preview-and-test)
* [Omvisning i startdialog](/getting-started/start-dialog)
# Forhåndsvisning og test (/no/features/preview-and-test)
Forhåndsvisningspanelet (høyre side av root-dialogen) viser hvordan en melding ser ut for den aktive arkraden.
## Hva forhåndsvisningen viser [#hva-forhåndsvisningen-viser]
| Felt | Innhold |
| ------------ | ------------------------------------------------------------------------------- |
| **From:** | Din påloggede Google-konto-e-post |
| **To:** | Verdi fra **Recipient column** for aktiv rad, eller `Select a recipient column` |
| **Subject:** | Mal-emne som lagret (ikke merge-substituert) |
| Body | Malbrødtekst med flettefelt brukt for den raden |
Hvis **Remove branding** er av, inkluderer forhåndsvisningen MailG-vannmerke-foten (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## Hva som ikke vises [#hva-som-ikke-vises]
* **CC** / **BCC**-rader rendres ikke i forhåndsvisnings-UI (selv når tilordnet under **More options**). De brukes fortsatt ved sending.
* Attachment-kolonneverdier vises ikke i forhåndsvisning.
## Naviger rader [#naviger-rader]
Forhåndsvisningsverktøylinje:
* **Edit template** — åpner oppdater-mal-skjermen
* **Previous recipient** / **Next recipient** — flytt mellom datarader (tooltips kan inkludere arkradnummer; overskrift er rad 1, så første kontakt er rad 2)
## Send meg en test-e-post [#send-meg-en-test-e-post]
1. Konfigurer mal + mottakerkolonne slik at forhåndsvisning er gyldig.
2. Åpne send-menyen (chevron) → **Send me a test email**.
3. Opptatt-overlay: `Sending test email…`
4. Suksess-toast: `Test email sent successfully. Check your inbox.`
5. Feil-toast: `Failed to send test email. Please check your email settings.`
6. Guard hvis forhåndsvisning er ufullstendig: `Configure your preview first`
Testen går til **din** Google-konto-innboks, med den aktive forhåndsvisningsradens flettede brødtekst.
## Tips [#tips]
* Gå gjennom flere rader med pilene før full sending
* Bekreft branding / ingen branding i forhåndsvisning
* Test alltid før **Schedule send** eller stor **Send N email(s)**
## Relatert [#relatert]
* [Flettefelt](/features/merge-tags)
* [Mail merge-veiledning](/getting-started/mail-merge-tutorial)
# Sendetempo (/no/features/send-pacing)
Send pacing legger til forsinkelse mellom meldinger, slik at en stor kampanje ikke forlater kontoen din som ett enkelt burst.
**Steady pace** og **Jittered gaps** krever et aktivt betalt MailG-abonnement. Gratis kontoer bruker kun **Burst send**.
## Hvor du konfigurerer [#hvor-du-konfigurerer]
Åpne tannhjulet i bunntekst (tooltip **Send pacing**). Skjermoverskrift: **Send pacing**.
Under **Dispatch mode**, velg hvordan e-poster fordeles. **Gap between emails** settes i **seconds** (0–60). Gratis kontoer ser **Pro features** og den låste teksten: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Standard for nye jobber: **Burst send**, gap **10s** (gap ignoreres til du forlater burst).
## Moduser [#moduser]
| Modus (UI-etikett) | Oppførsel |
| ------------------------- | -------------------------------------------- |
| **Burst send** (standard) | Send så raskt kvoter tillater |
| **Steady pace** | Vent et fast gap mellom hver e-post |
| **Jittered gaps** | Vent et tilfeldig gap mellom 0 og valgt maks |
## Hvorfor bruke pacing [#hvorfor-bruke-pacing]
* Reduser sjansen for å se ut som et plutselig burst for postleverandører
* Spre en lang liste over et roligere sendevindu
* Hold deg innenfor Gmail-komfortsoner for kontotypen din
## Merknader [#merknader]
* Pacing er en kampanjeinnstilling lagret med jobben — nye sendinger bruker gjeldende konfigurasjon
* Et langt gap på en stor liste øker total kampanjevarighet betydelig
* Din effektive hastighet er fortsatt begrenset av MailG daglig kvote **og** Gmails gjenstående sendekvote
* Konkurrentverktøy uttrykker noen ganger forsinkelse i minutter — MailG bruker **seconds**
## Relatert [#relatert]
* [Stoppe en kampanje](/features/stopping-a-campaign) hvis et gap ble satt for høyt midt i kjøring
* [Konto og fakturering](/help/account-and-billing)
# Stoppe en kampanje (/no/features/stopping-a-campaign)
MailG har ennå ikke en dedikert **Manage Schedule**, **Abort** eller **Pause**-skjerm som noen konkurrenter. Du kan likevel stoppe **gjenværende** rader fra å sendes.
## Slik bestemmer sendingen hva som behandles [#slik-bestemmer-sendingen-hva-som-behandles]
Sendeløkken behandler kun rader der kampanjekolonne-status fortsatt er sendbar:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
Rader allerede merket **✉️ Sent**, **⚠️ Failed** eller **👀 Opened** hoppes over.
## Stopp gjenværende rader (ærlig workaround) [#stopp-gjenværende-rader-ærlig-workaround]
Handle raskt på en stor kampanje:
1. Åpne regnearket.
2. I kampanjestatus-kolonnen, tøm eller endre status på rader som **ikke** skal sendes (for eksempel slett celleverdien, eller sett en ikke-sendbar etikett som `Stopped`).
3. La rader som allerede er **✉️ Sent** være — disse meldingene er allerede ute.
Rader du tømmer/endrer matcher ikke lenger sendbare statuser, så køen hopper over dem ved neste pass.
Gmail-meldinger som allerede har forlatt kontoen kan ikke angres av MailG. Å stoppe beskytter bare rader som ikke er behandlet ennå.
## Planlagte kampanjer som ikke har startet [#planlagte-kampanjer-som-ikke-har-startet]
Hvis hver rad fortsatt er **🗓️ Scheduled** og starttidspunktet ikke er nådd, forhindrer tømming av disse statusene (eller kampanjekolonnen) at køen plukker dem opp når tiden kommer.
Hvis du er usikker, kontakt [contact@mailg.io](mailto:contact@mailg.io) med regneark-URL og kampanjedetaljer.
## Relatert [#relatert]
* [Kampanjeplanlegging](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Tilpasset avsender (/no/features/customized-sender)
Som standard sender Gmail fra Google-kontoen som autoriserte MailG. Du kan likevel tilpasse hvordan navnet ditt vises og hvor svar går.
## Avsender navn [#avsender-navn]
1. Åpne **More options** i kampanjesidepanelet.
2. Sett **Sender name** (plassholder `John Doe (Optional)`).
3. Mottakere ser det visningsnavnet i innboksen (underlagt Gmails vanlige presentasjonsregler).
## Svaradresse [#svaradresse]
Sett **Reply to address** (plassholder `john@doe.com (Optional)`) hvis svar skal gå et annet sted enn sendekontoen.
## Merknader [#merknader]
* Den underliggende From-adressen forblir den autoriserte Gmail-kontoen — du kan ikke etterligne en annen postboks
* Ugyldige reply-to-adresser kan gi leverings- eller svarproblemer — bruk en postboks du kontrollerer
* Forhåndsvisning viser **From:** som din påloggede e-post; bekreft reply-to med **Send me a test email**
* Se [Forhåndsvisning og test](/features/preview-and-test)
# Omvisning i startdialog (/no/getting-started/start-dialog)
Åpne tillegget med **Extensions → MailG for Gmail → 🚀 Start**. En 900×600-dialog med tittelen **MailG for Gmail** åpnes.
## Skjermer [#skjermer]
| Skjerm | Slik kommer du dit | Formål |
| ----------------- | ---------------------------------------------- | --------------------------------------- |
| Root (composer) | Standard etter lasting | Velg mal + mottakere, forhåndsvis, send |
| Opprett mal | **New Template** | Navn, emne, brødtekst |
| Administrer maler | Mal-ikon (tooltip **Manage templates**) | Liste, rediger, slett |
| Oppdater mal | **Edit template** eller rad **Edit** | Rediger en eksisterende mal |
| Innstillinger | Tannhjul i bunntekst (tooltip **Send pacing**) | Dispatch mode + gap |
| Tomt ark | Ingen gyldig e-postkolonne | Spør om kontakter eller mock data |
| API / ark-feil | Lastefeil | Veiledning for nytt forsøk |
## Root-layout [#root-layout]
Tre soner:
1. **Sidebar** (venstre) — mal, mottakerkolonne, **More options**, sporing, branding, kvote
2. **Preview** (høyre) — From / To / Subject / brødtekst, radnavigasjon, **Edit template**
3. **Footer** — send-knapp, send-meny, **Upgrade to Pro** (gratis), innstillinger, hjelp
## Sidepanelkontroller (eksakte etiketter) [#sidepanelkontroller-eksakte-etiketter]
* **New Template**
* **Template** (select) — plassholder `Select` eller `No templates found`
* **Recipient column** — alternativer som `A - Email`; tom: `No valid email columns found.`
* **More options** — utvider **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (på som standard)
* **Remove branding** (betalt)
* **Daily quota** — gjenstående som «N left» og planlinje «Your plan sends up to TOTAL/day»
Gratis kontoer ser også **Leave a 5★ review for +N/day free** og **Or upgrade your plan**. Se [Daglig kvote og anmeldelser](/help/daily-quota-and-reviews).
## Send-kontroller i bunntekst [#send-kontroller-i-bunntekst]
| Kontroll | Etikett |
| ------------------ | ------------------------------------------------------------------------------------- |
| Primærknapp | **Send N email(s)** (eller **Send emails** når telling er 0) |
| Send-meny | **Send me a test email** |
| Send-meny | **Schedule send** |
| Oppgrader (gratis) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Tannhjul | tooltip **Send pacing** |
| Hjelp | tooltip **Help** — åpner sjekklisten i dialogen |
### Need help?-sjekkliste [#need-help-sjekkliste]
1. Velg en mal og mottakerkolonne
2. Forhåndsvis hver rad med pilene
3. Send en test-e-post til deg selv først
4. Klikk Send for å merge fra arket ditt
Knapper: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (hvis tilgjengelig) | **Close**
## Tomt ark [#tomt-ark]
Hvis MailG ikke finner en gyldig e-postkolonne:
* Tittel: **No email address found in your sheet**
* Handlinger: **Close** | **Fill with mock data**
Mock data legger inn overskriftene `Email`, `First Name`, `Last Name`, `Company` og kan opprette **My First Template**.
## Feilskjermer [#feilskjermer]
| Tittel | Når |
| --------------------------------- | ---------------------- |
| **Could not reach the MailG API** | API / nettverksfeil |
| **Could not read your sheet** | Feil ved lesing av ark |
## Neste [#neste]
# Installasjon (/no/getting-started/installation)
To steg: installer tillegget, og start det deretter fra Sheets.
## Installer MailG [#installer-mailg]
1. Åpne [MailG-listingen på Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Klikk **Install**.
3. Velg Google-kontoen som skal eie installasjonen.
4. Gå gjennom tillatelsene og klikk **Allow**.
Installasjonen tar vanligvis under 15 sekunder. Du bør se en bekreftelse på at tillegget er installert.
Hvis Marketplace-listingen ikke er live i regionen din ennå, bruk installasjons-CTA på [www.mailg.io](https://www.mailg.io) eller kontakt [contact@mailg.io](mailto:contact@mailg.io).
## Start MailG i Google Sheets [#start-mailg-i-google-sheets]
1. Åpne [Google Sheets](https://sheets.google.com) (oppdater hvis Sheets allerede var åpent).
2. Vent noen sekunder til Extensions lastes (ofte \~10–15 sekunder).
3. Gå til **Extensions → MailG for Gmail → 🚀 Start**.
Senere kan du kjøre **Extensions → MailG for Gmail → 🔄 Refresh Tracking** for å synkronisere åpningsstatus uten å åpne hele dialogen.
## Installasjonsproblemer [#installasjonsproblemer]
Dette er vanlige Google Workspace-quirks, ikke MailG-feil:
### Jeg ser aldri «installed successfully»-popupen [#jeg-ser-aldri-installed-successfully-popupen]
Dette skjer ofte når flere Google-kontoer er pålogget, og installasjonen ikke brukte kontoen du forventet.
**Workaround:** åpne et privat/inkognito-vindu, logg inn med bare målkontoen, og installer på nytt fra Marketplace.
### MailG vises ikke under Extensions [#mailg-vises-ikke-under-extensions]
1. Oppdater regnearket.
2. Vent omtrent 10–15 sekunder til tillegg lastes.
3. Bekreft at du er i samme Google-konto som installerte MailG.
4. Prøv et annet regneark eller tøm nettleserens cache hvis det fortsatt mangler.
## Selvhostet / egne distribusjoner [#selvhostet--egne-distribusjoner]
Marketplace-installasjoner er forhåndskonfigurert. Hvis du distribuerer MailG selv, sett Apps Script script properties:
| Property | Value |
| ------------- | --------------------------------- |
| `APP_URL` | Offentlig HTTPS-URL til MailG API |
| `APP_API_KEY` | Samme nøkkel som API-serveren |
Tillegget kan ikke nå `localhost` fra Googles servere — bruk en tunnel (Cloudflare Tunnel, ngrok osv.) for lokal testing.
## Neste [#neste]
Fortsett med [mail merge-veiledningen](/getting-started/mail-merge-tutorial).
# Mail merge-veiledning (/no/getting-started/mail-merge-tutorial)
Denne gjennomgangen følger startdialogen **MailG for Gmail**.
## 1. Åpne MailG [#1-åpne-mailg]
**Extensions → MailG for Gmail → 🚀 Start**.
Hvis du ser **No email address found in your sheet**, legg enten til ekte e-poster eller klikk **Fill with mock data** (oppretter eksempelrader og ofte **My First Template**). Se [Omvisning i startdialog](/getting-started/start-dialog).
## 2. Opprett eller velg en mal [#2-opprett-eller-velg-en-mal]
1. Klikk **New Template** (eller velg en eksisterende under **Template**).
2. Sett **Template Name** og **Email Subject** (emne **merge-substitueres ikke** i dag).
3. Skriv brødteksten og sett inn [flettefelt](/features/merge-tags) via **Merge Tag**.
4. **Save Template**.
Eksempel på brødtekst:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Konfigurer kampanjen [#3-konfigurer-kampanjen]
I sidepanelet:
1. Velg **Recipient column** (celler må være gyldige enkelte e-poster for at UI skal telle dem).
2. Åpne **More options** for **CC**, **BCC**, **Sender name**, **Reply to address**.
3. La **Track emails** stå på (standard) hvis du vil ha åpningsstatus i arket.
4. På betalt plan, aktiver **Remove branding**.
**Attachments** vises under **More options**, men filer legges ikke ved ved sending ennå. Lenk til Drive eller en URL i brødteksten i stedet.
## 4. Forhåndsvis og test [#4-forhåndsvis-og-test]
1. Bruk forrige/neste-pilene for å gå gjennom rader.
2. Bekreft **To:** og den flettede brødteksten (emne viser rå mal-emne).
3. Send-meny → **Send me a test email**.
4. Sjekk innboksen din.
Detaljer: [Forhåndsvisning og test](/features/preview-and-test).
## 5. Send eller planlegg [#5-send-eller-planlegg]
* Primærknapp: **Send N email(s)** når mottakere er talt.
* Eller send-meny → **Schedule send** → velg dato/klokkeslett → **Schedule Send**.
Opptatt-overlays: `Starting your campaign…` / planleggingsbekreftelse-toasts.
MailG legger til en kampanjekolonne som `🚀 My Template (yyyy/MM/dd)` eller `🗓️ …` når planlagt.
Radstatuser:
| Status | Betydning |
| ------------- | -------------------- |
| 🗓️ Scheduled | Venter på start |
| ⏳ Sending… | Behandles |
| ✉️ Sent | Overlevert til Gmail |
| ⚠️ Failed | Feil |
| 👀 Opened | Åpningspiksel lastet |
## Vanlige feil [#vanlige-feil]
* Emnefelt som forventer personalisering — kun brødtekst for nå
* Mottakerceller med flere komma-separerte adresser — UI validerer **én** e-post per celle for telling
* Feil Google-konto vs. installasjonskonto
* Daglig kvote nådd — sjekk **Daily quota** i sidepanelet
## Tips [#tips]
* Bruk **Help**-sjekklisten i bunnteksten første gang
* Start med 2–3 ekte rader etter mock data
* Etter åpninger: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → varsel `Tracking info synced` (eller `No active campaigns`)
## Neste [#neste]
# Hva er MailG? (/no/getting-started/what-is-mailg)
MailG gjør et Google Sheet om til en mail-merge-kampanje. Hver rad er en mottaker; kolonneoverskrifter blir flettefelt (doble krøllparenteser rundt overskriftsnavnet) i **email body**.
## Hva du kan gjøre [#hva-du-kan-gjøre]
* Opprette skybaserte maler (**Template Name**, **Email Subject**, rik brødtekst)
* Personalisere **body** med flettefelt fra arkoverskrifter
* Forhåndsvise rader og **Send me a test email**
* Tildele **CC** / **BCC**, **Sender name**, **Reply to address**
* **Schedule send** eller sende med én gang
* **Track emails** med åpningsstatus i arket
* Styre **Send pacing** på betalte planer
* **Remove branding** på betalte planer
* Følge med på **Daily quota** (og eventuelt hente en gratis anmeldelsesbonus)
## Slik henger det sammen [#slik-henger-det-sammen]
1. **Google Sheets add-on** — dialog under **MailG for Gmail**
2. **MailG API** — maler, kampanjemetadata, åpningssporing og rettigheter
3. **Din Gmail** — meldinger sendes med `GmailApp` fra den autoriserte kontoen
## Neste steg [#neste-steg]
# Kontakta oss (/sv/contact-us)
## Fakturering och prenumerationer [#fakturering-och-prenumerationer]
Du kan hantera de flesta prenumerationsändringar via Stripe-portalen som länkas från [pricing](https://app.mailg.io/pricing?lang=sv). För återbetalningar eller betalningsproblem, maila oss.
## Allt annat [#allt-annat]
Maila **[contact@mailg.io](mailto:contact@mailg.io)**.
Vi svarar vanligtvis inom en arbetsdag.
## Användbara länkar [#användbara-länkar]
* [Webbplats](https://www.mailg.io)
* [Priser](https://app.mailg.io/pricing?lang=sv)
* [Integritet](https://www.mailg.io/sv/privacy)
* [Villkor](https://www.mailg.io/sv/terms)
* [Dokumentation](/)
# MailG-dokumentation (/sv)
MailG är ett Google Sheets-tillägg för mail merge med Gmail. Öppna **Extensions → MailG for Gmail → 🚀 Start**, skapa en mall, förhandsgranska rader och skicka eller schemalägg från ditt eget Gmail-konto.
## Börja här [#börja-här]
## Populära ämnen [#populära-ämnen]
## Användbara länkar [#användbara-länkar]
* Webbplats: [www.mailg.io](https://www.mailg.io)
* Dokumentation: [docs.mailg.io/sv](https://docs.mailg.io/sv)
* Priser: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=sv)
* Kontakt: [contact@mailg.io](mailto:contact@mailg.io)
## För AI-assistenter / LLM:er [#för-ai-assistenter--llmer]
Föredra dessa maskinläsbara endpoints framför att scrapa HTML:
* [Agents hub](https://www.mailg.io/sv/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/sv/help/faq)
## Installation och öppning [#installation-och-öppning]
**Hur öppnar jag MailG?**\
**Extensions → MailG for Gmail → 🚀 Start**. Se [Installation](/getting-started/installation).
**No email address found in your sheet**\
Lägg till e-postadresser i en kolumn, eller klicka **Fill with mock data**. Se [Genomgång av startdialogen](/getting-started/start-dialog).
**Could not reach the MailG API**\
Kontrollera nätverk / API-URL (självhostad: `APP_URL` + `APP_API_KEY`). Öppna dialogen igen efter åtgärd.
## Sändning [#sändning]
**E-post skickas inte**\
Kontrollera **Daily quota**, Gmail-behörigheter och att **Recipient column**-celler är giltiga enskilda e-postadresser. Fel visar **⚠️ Failed**.
**Fungerar subject merge tags?**\
Inte ännu. Endast **body** mergas. Behåll fast ämne eller lägg personifiering i body. Se [Merge tags](/features/merge-tags).
**Kan jag bifoga filer?**\
**Attachments**-väljaren finns under **More options**, men filer bifogas inte vid sändning ännu. Använd länkar.
**Hur stoppar jag en kampanj?**\
[Stoppa en kampanj](/features/stopping-a-campaign) — rensa sändbara statusar på återstående rader.
**Varför är jag begränsad på Professional?**\
MailG kan tillåta upp till 1 500/dag, men gratis `@gmail.com` begränsas ofta till cirka 500 av Google.
## Spårning [#spårning]
**Kalkylbladet säger fortfarande Sent efter öppning**\
**🔄 Refresh Tracking** → förvänta `Tracking info synced`. Vissa klienter laddar aldrig bilder.
**Klick?**\
Spåras inte. **Track emails** = endast öppningar.
## Kvot och fakturering [#kvot-och-fakturering]
Se [Daily quota & reviews](/help/daily-quota-and-reviews) och [Konto och fakturering](/help/account-and-billing).
**Är Schedule send betald?**\
Nej. Betalt låser upp högre kvoter, pacing-lägen och **Remove branding**.
## Felsökning [#felsökning]
För steg-för-steg-fixar (API-fel, tomt kalkylblad, inaktiverad skickknapp, misslyckade rader, spårning, kvot, schema skjuter inte upp), se [Felsökning](/help/troubleshooting).
Vanliga toasts du kan se:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Fortfarande fast? [#fortfarande-fast]
[Felsökning](/help/troubleshooting) · Docs [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Felsökning (/sv/help/troubleshooting)
Snabbfixar för meddelanden och tillstånd du ser i tillägget.
## Dialogen laddas inte [#dialogen-laddas-inte]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
Startdialogen kunde inte anropa MailG-backend.
* Bekräfta att du är online
* Marketplace-installationer: vänta en stund och öppna **🚀 Start** igen
* Självhostad: kontrollera Apps Script properties `APP_URL` (offentlig HTTPS) och `APP_API_KEY`
* Tillägget kan inte använda `localhost` — använd en tunnel för lokal API-testning
### Could not read your sheet [#could-not-read-your-sheet]
MailG kunde inte läsa det aktiva kalkylbladet.
* Se till att en arkflik är öppen (inte bara Apps Script-editorn)
* Ladda om kalkylbladet, öppna sedan dialogen igen
* Bekräfta att du har redigeringsåtkomst till filen
### Loading… slutar aldrig [#loading-slutar-aldrig]
Stäng dialogen, uppdatera Sheets, vänta \~15 sekunder på Extensions, sedan **🚀 Start** igen.
## Tomt kalkylblad [#tomt-kalkylblad]
**No email address found in your sheet**
MailG behöver minst en kolumn med giltiga e-postadresser.
* Lägg till e-postadresser under en rubrik, eller klicka **Fill with mock data**
* Mock data skapar `Email`, `First Name`, `Last Name`, `Company` och ofta **My First Template**
Se [Genomgång av startdialogen](/getting-started/start-dialog).
## Mallar [#mallar]
* Skapa: `Creating Template...` → `Template created successfully!` eller `Failed to create template! Try again later.`
* Uppdatera: `Updating template...`
* Ta bort-fel: `Failed to delete template. Try again later`
Se [Mallar](/features/templates).
## Sändningsproblem [#sändningsproblem]
### Skickknapp inaktiverad / Send emails utan räkning [#skickknapp-inaktiverad--send-emails-utan-räkning]
* Välj en **Template**
* Välj en **Recipient column** med giltiga **enskilda** e-postadresser per cell
* Guard toasts du kan se: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### Kampanj startar inte [#kampanj-startar-inte]
Toast: `Failed to create campaign. Please try again.`
* Försök igen en gång
* Kontrollera att **Daily quota** inte är 0
* Bekräfta API-anslutning (se ovan)
### Rader visar ⚠️ Failed [#rader-visar-️-failed]
Den raden fick ett sändningsfel (ogiltig adress, Gmail-avvisning, tillfällig kvot, etc.). Åtgärda data och starta en ny kampanj för återstående rader, eller se [Stoppa en kampanj](/features/stopping-a-campaign).
### Testmail misslyckas [#testmail-misslyckas]
* `Configure your preview first` — välj mall + mottagare så förhandsgranskning har To
* `Failed to send test email. Please check your email settings.` — auktorisera Gmail igen vid behov, försök sedan igen
## Spårning [#spårning]
* Öppningar kräver att mottagaren laddar externa bilder
* Kör **🔄 Refresh Tracking** — förvänta `Tracking info synced` eller `No active campaigns`
* Status **👀 Opened** visas endast när pixeln laddas
Se [E-postspårning](/features/email-tracking).
## Kvot och branding [#kvot-och-branding]
* Sidopanel **N left** är `min(MailG remaining, Gmail remaining)`
* Gratis `@gmail.com` begränsas ofta till cirka 500/dag av Google även på Professional
* Vattenstämpel kvar efter betalning → checkout-e-post måste matcha Sheets-konto; öppna dialogen igen
Se [Daily quota & reviews](/help/daily-quota-and-reviews) och [Ta bort branding](/features/remove-branding).
## Schema skjöt inte upp [#schema-skjöt-inte-upp]
Tider mindre än cirka **15 sekunder** framåt behandlas som **omedelbar** sändning (🚀 kolumn), inte uppskjuten 🗓️ schemaläggning. Välj en tid längre fram.
## Fortfarande fast? [#fortfarande-fast]
Full FAQ: [FAQ](/help/faq) · E-post [contact@mailg.io](mailto:contact@mailg.io) · Webbplats [app.mailg.io/help](https://www.mailg.io/sv/help)
# Daglig kvot och recensioner (/sv/help/daily-quota-and-reviews)
Root-sidopanelen visar din sändningskapacitet när kontodata har laddats.
## Daily quota-block [#daily-quota-block]
Exakt UI:
* Etikett: **Daily quota**
* Kvar: **N left**
* Planrad: **Your plan sends up to TOTAL/day**
**Remaining** är minimum av:
1. MailG-plan kvar för dagen
2. Gmail kvarvarande sändningskvot för kontot
Du kan alltså begränsas av Gmail även när MailG fortfarande visar utrymme på pappret. Se även [Konto och fakturering](/help/account-and-billing).
## Gratisplan CTAs [#gratisplan-ctas]
När du inte prenumererar kan sidopanelen visa:
* **Leave a 5★ review for +N/day free** (standardbonus är **+50/day** när API inte anger annat)
* **Or upgrade your plan**
Klick på recensions-CTA öppnar **Free Quota upgrade**:
* Titel: **Free Quota upgrade**
* Brödtext: lämna en 5-stjärnig recension för gratis kvotuppgradering på **+N emails/day**
* Knappar: **Not now** | **Leave a 5★ review**
Om recensions-URL inte är konfigurerad förblir **Leave a 5★ review** inaktiverad — använd **Upgrade to Pro** / pricing istället.
## Uppgradera till Pro [#uppgradera-till-pro]
Sidfotsknapp (gratiskonton): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
Det matchar vad betalda planer låser upp i produkten idag.
## Relaterat [#relaterat]
* [Ta bort branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Konto och fakturering (/sv/help/account-and-billing)
MailG-fakturering är kopplad till **e-postadressen för ditt Google-konto** i Sheets. Checka alltid ut med samma adress så kvoter låses upp i tillägget.
## Planer och dagliga kvoter [#planer-och-dagliga-kvoter]
| Plan | Daily quota | Anteckningar |
| ------------ | ----------- | -------------------------------------------- |
| Free | 50 | Kärn-merge, öppningsspårning, schemaläggning |
| Personal | 250 | Populär plan för växande listor |
| Professional | 1 500 | Högsta återkommande kvot |
| Lifetime | 1 500 | Engångsköp |
Priser och intervall listas på [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=sv) (EUR och USD).
Betalda rättigheter låser också upp:
* Icke-standard [send pacing](/features/send-pacing) (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Din effektiva sändvolym är `min(MailG daily quota, Gmail remaining quota)`.
## Så uppgraderar du [#så-uppgraderar-du]
1. Öppna [pricing](https://app.mailg.io/pricing?lang=sv) (länkas också från tillägget via **Upgrade to Pro**).
2. Välj en plan och slutför Stripe Checkout med din Sheets Google-e-post.
3. Öppna MailG i Sheets igen så kontouppdateringen plockar upp den nya gränsen.
## Säg upp eller uppdatera prenumeration [#säg-upp-eller-uppdatera-prenumeration]
Du kan säga upp eller ändra prenumerationen från Stripe-kundportalen länkad i din prenumerations- / pricing-flöde.
* Om du säger upp mitt i cykeln förblir Premium-funktioner aktiva till slutet av betalperioden
* Du debiteras inte igen efter att uppsägningen trätt i kraft
## Återbetalningar [#återbetalningar]
Om du säger upp en Premium-prenumeration inom **30 dagar** efter köp kan du begära full återbetalning via e-post till [contact@mailg.io](mailto:contact@mailg.io).
## Fakturor [#fakturor]
Stripe skickar kvitton för lyckade betalningar. Du kan också ladda ner fakturor från Stripe-kundportalen för prenumerationshantering.
## FAQ-utdrag [#faq-utdrag]
**Ingår MailG i Google Workspace?**\
Nej. MailG är oberoende av Google. En Workspace-prenumeration inkluderar inte MailG.
**Vilka betalningsmetoder accepteras?**\
Större kort, Google Pay och Apple Pay via Stripe. PayPal stöds inte.
**Jag betalade men ser fortfarande gratisgräns / vattenstämpel**\
Nästan alltid e-postfelmatchning. Bekräfta checkout-e-post = Sheets-kontots e-post, öppna sedan tillägget igen. Om det kvarstår, kontakta support med båda e-postadresserna.
**Varför är gratis Gmail begränsad till cirka 500 e-post per dag?**\
MailG Professional tillåter upp till 1 500 e-post per dag, men Google begränsar gratis `@gmail.com`-konton till ungefär 500 sändningar per dag. Google Workspace-konton kan gå högre. Detta är en Gmail-leverantörsgräns, inte en MailG-gräns.
# Kampanjplanering (/sv/features/campaign-scheduling)
Använd **Schedule send** när du vill att MailG ska starta senare. Tillgängligt på gratis och betalda planer.
## Så schemalägger du [#så-schemalägger-du]
1. Konfigurera mall och mottagare så skickknappen är aktiverad.
2. Öppna skickmenyn (chevron) → **Schedule send**.
3. Dialogtitel: **Schedule send**
4. Beskrivning: `Pick date & time to schedule sending`
5. Sammanfattningsrad: schemalägger N e-postmeddelanden att skickas från valt datum/tid
6. Använd datumväljaren plus **Hour** / **Minute** (platshållare `Hour`, `Min`).
7. Bekräfta med **Schedule Send** (eller **Cancel**).
Standardförslag är cirka **60 minuter framåt**, avrundat till nästa **15-minuters** steg.
## Omedelbart vs schemalagt [#omedelbart-vs-schemalagt]
Tider mindre än cirka **15 sekunder** framåt behandlas som **omedelbar** sändning (🚀 kolumnrubrik), inte uppskjuten 🗓️ schemaläggning. Välj en tid längre fram om du behöver uppskjuten sändning.
Valideringstoasts: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Success toast: kampanj schemalagd; N e-postmeddelanden startar vid vald tid.
## Kalkylbladskolumn [#kalkylbladskolumn]
Schemalagda kampanjer skapar en kolumnrubrik som:
```text
🗓️ Template name (yyyy/MM/dd)
```
Omedelbara sändningar använder 🚀 istället för 🗓️.
Rader börjar som **🗓️ Scheduled**, flyttas sedan till **⏳ Sending…** när kön körs.
## Efter schemaläggning [#efter-schemaläggning]
* Håll kalkylbladet tillgängligt för Google-kontot som äger tillägget
* Spårning och pacing gäller fortfarande när sändningen startar
* Ingen **Manage Schedule**-UI — se [Stoppa en kampanj](/features/stopping-a-campaign)
## Relaterat [#relaterat]
* [Förhandsgranska och testa](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Flera mottagare (/sv/features/multiple-recipients)
Du kan lägga till kopia-mottagare per rad med dedikerade kalkylbladskolumner.
## Mottagarkolumn (Till) [#mottagarkolumn-till]
Välj **Recipient column** i sidopanelen.
För skickknappens räkning och kolumnvalidering behandlar MailG en cell som giltig när den innehåller **en** e-postadress. Föredra en primär To-adress per rad.
## CC- och BCC-kolumner [#cc--och-bcc-kolumner]
1. Lägg till kolumner i kalkylbladet (till exempel `CC` och `BCC`).
2. Ange en e-post (eller Gmail-accepterad lista) i cellen.
3. Öppna **More options** och mappa **CC** / **BCC**.
4. Vid sändning skickas dessa värden till Gmail.
Förhandsgranskningsrutan visar endast **From**, **To**, **Subject** och body. Den visar **inte** CC/BCC-rader även när mappade. Bekräfta med **Send me a test email** om du behöver verifiera CC/BCC-leverans.
## Kvoter: MailG vs Gmail [#kvoter-mailg-vs-gmail]
* **MailG daily quota** räknar **kampanjrader** som bearbetas.
* **Gmail sending limits** räknar **mottagare** (To + CC + BCC-adresser Gmail accepterar vid den sändningen).
Du kan fortfarande träffa Gmails tak medan MailG-kvot återstår.
## Tips [#tips]
* Föredra **BCC** när mottagare inte ska se varandra
* Lämna CC/BCC omappade när de inte används
* Validera adresser före stor sändning
# Attachments (/sv/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Funktionsöversikt (/sv/features/features-overview)
Det tillägget stöder idag:
| Funktion | Docs |
| --------------------------------------------- | ----------------------------------------------------------- |
| Startdialog / tomt kalkylblad / mock data | [Genomgång av startdialogen](/getting-started/start-dialog) |
| Mallar (skapa / hantera / redigera / ta bort) | [Mallar](/features/templates) |
| Merge tags i **body** | [Merge tags](/features/merge-tags) |
| Rich-text-verktygsfält | [Rich-text emails](/features/rich-text-emails) |
| Länkar (inte inbäddade bilder) | [Bilder](/features/images) |
| Förhandsgranskning + testmail | [Förhandsgranska och testa](/features/preview-and-test) |
| Schemalägg sändning | [Kampanjschemaläggning](/features/campaign-scheduling) |
| Send pacing (betald) | [Send pacing](/features/send-pacing) |
| CC / BCC-kolumner | [Flera mottagare](/features/multiple-recipients) |
| Track emails | [E-postspårning](/features/email-tracking) |
| Sender name & reply-to | [Anpassad avsändare](/features/customized-sender) |
| Remove branding (betald) | [Ta bort branding](/features/remove-branding) |
| Stoppa återstående rader | [Stoppa en kampanj](/features/stopping-a-campaign) |
| Daily quota + recensionsbonus | [Daily quota & reviews](/help/daily-quota-and-reviews) |
## Betald vs gratis [#betald-vs-gratis]
Betalt låser upp:
* Icke-standard [send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* Högre [daily quotas](/help/account-and-billing)
**Schedule send**, **Track emails** och mallverktyg fungerar utan betald uppgradering.
## Kända luckor (ärligt) [#kända-luckor-ärligt]
| Ämne | Status i produkten |
| ------------------------------- | ----------------------------------------- |
| Subject merge tags | Tillämpas inte vid sändning — endast body |
| Attachments-kolumn | Endast UI — bifogas inte vid sändning |
| Bildinbäddningar | Ingen editor-kontroll — använd länkar |
| Förhandsgranskning CC/BCC-rader | Visas inte i förhandsgransknings-UI |
| Manage Schedule / Pause | Inte lanserat — status-workaround |
## Kommer senare [#kommer-senare]
Avprenumerationslänkar, klickspårning, delade teamplatser och ett dedikerat kampanjhanterings-UI när de lanseras.
# E-postspårning (/sv/features/email-tracking)
MailG kan registrera öppningar med en liten osynlig pixel.
## Aktivera spårning [#aktivera-spårning]
I sidopanelen, låt **Track emails** vara på (standard är på för nya jobb).
Tooltip: `Track emails opened with a tiny pixel`
Hjälpikonen öppnar **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Knapp: **Got it**
## Kalkylbladsstatusar [#kalkylbladsstatusar]
| Status | Betydelse |
| ------------- | ---------------------------------- |
| 🗓️ Scheduled | Väntar på schemalagd start |
| ⏳ Sending… | Bearbetas just nu |
| ✉️ Sent | Levererad till Gmail för den raden |
| ⚠️ Failed | Sändningsfel för den raden |
| 👀 Opened | Öppningspixel laddades |
Kampanjkolumnrubriker ser ut som `🚀 Template name (yyyy/MM/dd)` eller `🗓️ …` vid schemaläggning.
## Uppdatera spårning [#uppdatera-spårning]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Apps Script-alerts:
* `Tracking info synced`
* `No active campaigns`
## Begränsningar [#begränsningar]
* Klienten måste ladda externa bilder
* Integritetsproxyer kan dölja öppningar
* Endast öppningar — inte länkklick
## Relaterat [#relaterat]
* [Kampanjschemaläggning](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Sammanfogningsfält (/sv/features/merge-tags)
Merge tags låter varje mottagare få en personifierad **body**. En tagg är den **exakta kolumnrubriken** omsluten av dubbla klammerparenteser.
## Syntax [#syntax]
Om kalkylbladet har en kolumn som heter `First Name`, använd:
```text
{{First Name}}
```
Body-exempel:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Var merge tags fungerar idag [#var-merge-tags-fungerar-idag]
| Fält | Merged vid sändning? |
| --------------- | ------------------------------------------- |
| Email body | **Ja** — variabler injiceras per rad |
| Email subject | **Nej** — ämnet skickas som lagrat i mallen |
| Preview body | **Ja** — för aktiv rad |
| Preview subject | **Nej** — visar det råa mallämnet |
Lägg personifiering i body tills subject merge lanseras.
## Infoga taggar [#infoga-taggar]
I editorverktygsfältet, öppna **Merge Tag**. Det listar rubriker från det aktiva kalkylbladet. Tomt tillstånd: `No sheet columns found`.
Infogad text använder dubbla klammerparenteser runt kolumnnamnet.
## Tumregler [#tumregler]
* Rubriker är skiftlägeskänsliga (`Name` ≠ `name`)
* Tomma celler infogas som tomma strängar
* Du kan återanvända samma tagg flera gånger i body
* Mottagare / CC / BCC väljs under **More options**, inte via merge tags
## Nästa [#nästa]
Se [Rich-text emails](/features/rich-text-emails) och [Förhandsgranska och testa](/features/preview-and-test).
# Rich text-e-post (/sv/features/rich-text-emails)
MailG-mallar använder en TipTap rich-text-editor. HTML:en den producerar är vad Gmail levererar.
Body-platshållare: `Write your email…`
## Verktygsfält (exakt UI) [#verktygsfält-exakt-ui]
| Grupp | Kontroller |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (förinställningar i verktygsfältet) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | Förinställda färgrutor + native color picker + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — URL-fält platshållare `https://example.com`, sedan **Apply** (och unlink) |
| History | **Undo**, **Redo** |
## Inte i editorn [#inte-i-editorn]
Dessa TipTap-funktioner är inaktiverade / saknas:
* Headings, code, code block, blockquote, horizontal rule
* Image insert / Drive media picker — se [Bilder](/features/images)
## Hyperlänkar [#hyperlänkar]
Använd **Insert link** för URL och synlig text. Föredra tydlig länktext framför råa URL:er.
## Tips [#tips]
* Använd **Merge Tag** istället för att skriva klammerparenteser för hand
* Förhandsgranska flera rader före sändning — se [Förhandsgranska och testa](/features/preview-and-test)
* Undvik enorm inklistrad Word/Docs-markup; applicera formatering igen i MailG för renare HTML
# Ta bort MailG-varumärket (/sv/features/remove-branding)
Gratiskampanjer kan inkludera en liten MailG-vattenstämpel i e-postsidfoten. Betalda prenumeranter kan stänga av den.
## Så tar du bort branding [#så-tar-du-bort-branding]
1. Bekräfta att du har en aktiv betald plan (Personal, Professional eller Lifetime).
2. Öppna kampanjens sidopanel.
3. Aktivera **Remove branding**.
4. Förhandsgranska en rad för att bekräfta att vattenstämpeln är borta, skicka sedan.
Om branding fortfarande visas efter betalning:
* Se till att checkout använde **samma e-post** som ditt Google Sheets-konto
* Öppna tillägget igen så det uppdaterar rättigheter från API
* Kontakta [contact@mailg.io](mailto:contact@mailg.io) med ditt Google-kontos e-post
Se [Konto och fakturering](/help/account-and-billing).
# Bilder (/sv/features/images)
MailG-editorn har **ingen image insert-knapp** och ingen Google Drive media picker. TipTaps Image-tillägg är inte aktiverat.
## Vad du kan göra idag [#vad-du-kan-göra-idag]
Använd **Insert link** i verktygsfältet:
1. Hosta bilden (eller filen) på en offentlig URL, eller dela en Drive-länk.
2. Markera text (eller placera markören) → **Insert link**.
3. Klistra in URL:en (platshållare `https://example.com`) → **Apply**.
Mottagare öppnar länken för att se bilden eller filen. Editorn bäddar inte in `![]()
`-taggar åt dig.
## Tips [#tips]
* Föredra små filer och tydlig länktext (”View screenshot”)
* Länkar som kräver inloggning misslyckas för mottagare
* Bekräfta med **Send me a test email**
## Kommer senare [#kommer-senare]
En förstklassig bildinbäddning / Drive picker kan lanseras senare. Tills dess är hyperlänkar den stödda vägen.
# Mallar (/sv/features/templates)
Mallar lagrar ämne och rich-text-body som du återanvänder i kampanjer. De sparas i MailG API för ditt Google-konto.
## Skapa en mall [#skapa-en-mall]
1. På root-skärmen, klicka **New Template**.
2. Fyll i:
* **Template Name**
* **Email Subject**
* Body (rich editor — se [Rich-text emails](/features/rich-text-emails))
3. Klicka **Save Template** (visar **Saving...** medan det arbetar).
Toasts:
* Loading: `Creating Template...`
* Success: `Template created successfully!`
* Error: `Failed to create template! Try again later.`
Demomall från **Fill with mock data**: namn **My First Template**, ämne `I found a mail merge tool for Gmail`.
## Hantera mallar [#hantera-mallar]
Öppna mallikonen bredvid mallvalet (tooltip **Manage templates**).
Tabellkolumner:
| Kolumn | Innehåll |
| ----------------- | ------------- |
| **Name** | Mallnamn |
| **Email Subject** | Ämnesrad |
| **Created At** | Skapelsedatum |
| **Actions** | Radmeny |
Radmeny: **Edit** | **Delete**
Sidfot: **Back**
Delete toasts: deleting template NAME → template NAME deleted successfully (eller felmeddelande).
## Redigera en mall [#redigera-en-mall]
Öppna **Edit** från hantera, eller klicka **Edit template** i förhandsgranskningsverktygsfältet.
Samma fält som vid skapande. **Save Template** uppdaterar mallen.
Uppdateringsflödet visar en loading toast (`Updating template...`). Stanna kvar på formuläret tills det är klart, använd sedan **Cancel** eller **Back** om du inte skickas tillbaka automatiskt.
## Ämne vs body [#ämne-vs-body]
* **Body** stöder [merge tags](/features/merge-tags) — de injiceras per rad vid sändning.
* **Email Subject** skickas som lagrad idag (merge tags i ämnet **ersätts inte** ännu). Lägg personifiering i body, eller använd ett fast ämne.
## Relaterat [#relaterat]
* [Förhandsgranska och testa](/features/preview-and-test)
* [Genomgång av startdialogen](/getting-started/start-dialog)
# Förhandsgranskning och test (/sv/features/preview-and-test)
Förhandsgranskningsrutan (höger sida av root-dialogen) visar hur ett meddelande ser ut för den aktiva kalkylbladsraden.
## Vad förhandsgranskningen visar [#vad-förhandsgranskningen-visar]
| Fält | Innehåll |
| ------------ | -------------------------------------------------------------------------------- |
| **From:** | Din inloggade Google-kontos e-post |
| **To:** | Värde från **Recipient column** för aktiv rad, eller `Select a recipient column` |
| **Subject:** | Mallämne som lagrat (inte merge-substitueras) |
| Body | Mallbody med merge tags tillämpade för den raden |
Om **Remove branding** är av inkluderar förhandsgranskningen MailG-vattenstämpeln i sidfoten (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## Vad som inte visas [#vad-som-inte-visas]
* **CC** / **BCC**-rader renderas inte i förhandsgransknings-UI (även när mappade under **More options**). De tillämpas fortfarande vid sändning.
* Attachment-kolumnvärden visas inte i förhandsgranskning.
## Navigera rader [#navigera-rader]
Förhandsgranskningsverktygsfält:
* **Edit template** — öppnar uppdatera-mall-skärmen
* **Previous recipient** / **Next recipient** — flytta mellan datarader (tooltips kan inkludera kalkylbladsradnummer; rubrik är rad 1, så första kontakten är rad 2)
## Skicka ett testmejl till mig [#skicka-ett-testmejl-till-mig]
1. Konfigurera mall + mottagarkolumn så förhandsgranskningen är giltig.
2. Öppna skickmenyn (chevron) → **Send me a test email**.
3. Busy overlay: `Sending test email…`
4. Success toast: `Test email sent successfully. Check your inbox.`
5. Failure toast: `Failed to send test email. Please check your email settings.`
6. Guard om förhandsgranskning ofullständig: `Configure your preview first`
Testet går till **din** Google-kontos inkorg, med den aktiva förhandsgranskningsradens mergade body.
## Tips [#tips]
* Gå igenom flera rader med pilarna före full sändning
* Bekräfta branding / ingen branding i förhandsgranskning
* Testa alltid före **Schedule send** eller stor **Send N email(s)**
## Relaterat [#relaterat]
* [Merge tags](/features/merge-tags)
* [Mail merge-handledning](/getting-started/mail-merge-tutorial)
# Sändningstakt (/sv/features/send-pacing)
Send pacing lägger till fördröjning mellan meddelanden så en stor kampanj inte lämnar ditt konto som en enda burst.
**Steady pace** och **Jittered gaps** kräver en aktiv betald MailG-prenumeration. Gratiskonton använder endast **Burst send**.
## Var du konfigurerar [#var-du-konfigurerar]
Öppna kugghjulet i sidfoten (tooltip **Send pacing**). Skärmrubrik: **Send pacing**.
Under **Dispatch mode**, välj hur e-postmeddelanden sprids. **Gap between emails** anges i **seconds** (0–60). Gratiskonton ser **Pro features** och den låsta texten: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Standard för nya jobb: **Burst send**, gap **10s** (gap ignoreras tills du lämnar burst).
## Lägen [#lägen]
| Läge (UI-etikett) | Beteende |
| ------------------------- | ------------------------------------------------------ |
| **Burst send** (standard) | Skicka så snabbt kvoter tillåter |
| **Steady pace** | Vänta ett fast gap mellan varje e-post |
| **Jittered gaps** | Vänta ett slumpmässigt gap mellan 0 och ditt valda max |
## Varför använda pacing [#varför-använda-pacing]
* Minska risken att se ut som en plötslig blast för mailbox-leverantörer
* Sprid en lång lista över ett lugnare sändningsfönster
* Håll dig inom Gmails komfortzoner för din kontotyp
## Anteckningar [#anteckningar]
* Pacing är en kampanjinställning lagrad med jobbet — nya sändningar använder aktuell konfiguration
* Ett långt gap på en stor lista ökar total kampanjtid avsevärt
* Din effektiva hastighet begränsas fortfarande av MailG daily quota **och** Gmails kvarvarande sändningskvot
* Konkurrentverktyg uttrycker ibland fördröjning i minuter — MailG använder **seconds**
## Relaterat [#relaterat]
* [Stoppa en kampanj](/features/stopping-a-campaign) om gap sattes för högt mitt i körning
* [Konto och fakturering](/help/account-and-billing)
# Stoppa en kampanj (/sv/features/stopping-a-campaign)
MailG har ännu ingen dedikerad **Manage Schedule**-, **Abort**- eller **Pause**-skärm som vissa konkurrenter. Du kan fortfarande stoppa **återstående** rader från att skickas.
## Hur sändningen bestämmer vad som bearbetas [#hur-sändningen-bestämmer-vad-som-bearbetas]
Sändningsloopen bearbetar endast rader vars kampanjkolumnstatus fortfarande är sändbar:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
Rader redan markerade **✉️ Sent**, **⚠️ Failed** eller **👀 Opened** hoppas över.
## Stoppa återstående rader (ärlig workaround) [#stoppa-återstående-rader-ärlig-workaround]
Agera snabbt på en stor kampanj:
1. Öppna kalkylbladet.
2. I kampanjstatuskolumnen, rensa eller ändra status på rader som **inte** får skickas (till exempel ta bort cellvärdet, eller sätt en icke-sändbar etikett som `Stopped`).
3. Låt redan **✉️ Sent**-rader vara — de meddelandena är redan ute.
Rader du rensar/ändrar matchar inte längre de sändbara statusarna, så kön hoppar över dem vid nästa pass.
Gmail-meddelanden som redan lämnat kontot kan inte ångras av MailG. Att stoppa skyddar endast rader som ännu inte bearbetats.
## Schemalagda kampanjer som inte startat [#schemalagda-kampanjer-som-inte-startat]
Om varje rad fortfarande är **🗓️ Scheduled** och starttiden inte kommit, förhindrar rensning av dessa statusar (eller kampanjkolumnen) att kön plockar upp dem när tiden kommer.
Om du är osäker, kontakta [contact@mailg.io](mailto:contact@mailg.io) med kalkylbladets URL och kampanjdetaljer.
## Relaterat [#relaterat]
* [Kampanjschemaläggning](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Anpassad avsändare (/sv/features/customized-sender)
Som standard skickar Gmail från Google-kontot som auktoriserade MailG. Du kan fortfarande anpassa hur ditt namn visas och vart svar går.
## Avsändarnamn [#avsändarnamn]
1. Öppna **More options** i kampanjens sidopanel.
2. Ange **Sender name** (platshållare `John Doe (Optional)`).
3. Mottagare ser det visningsnamnet i inkorgen (enligt Gmails vanliga presentationsregler).
## Svarsadress [#svarsadress]
Ange **Reply to address** (platshållare `john@doe.com (Optional)`) om svar ska gå någon annanstans än sändarkontot.
## Anteckningar [#anteckningar]
* Den underliggande From-adressen förblir det auktoriserade Gmail-kontot — du kan inte spoofa en annan mailbox
* Ogiltiga reply-to-adresser kan orsaka leverans- eller svarsproblem — använd en mailbox du kontrollerar
* Förhandsgranskning visar **From:** som din inloggade e-post; bekräfta reply-to med **Send me a test email**
* Se [Förhandsgranska och testa](/features/preview-and-test)
# Genomgång av startdialogen (/sv/getting-started/start-dialog)
Öppna tillägget med **Extensions → MailG for Gmail → 🚀 Start**. En dialog på 900×600 med titeln **MailG for Gmail** öppnas.
## Skärmar [#skärmar]
| Skärm | Hur du kommer dit | Syfte |
| ------------------ | ------------------------------------------- | ------------------------------------------------ |
| Root (composer) | Standard efter laddning | Välj mall + mottagare, förhandsgranska, skicka |
| Create template | **New Template** | Namn, ämne, brödtext |
| Manage templates | Mallikon (tooltip **Manage templates**) | Lista, redigera, ta bort |
| Update template | **Edit template** eller rad **Edit** | Redigera en befintlig mall |
| Settings | Kugghjul i sidfot (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | Ingen giltig e-postkolumn | Uppmana att lägga till kontakter eller mock data |
| API / sheet errors | Laddningsfel | Vägledning för nytt försök |
## Root-layout [#root-layout]
Tre zoner:
1. **Sidebar** (vänster) — mall, mottagarkolumn, **More options**, spårning, branding, kvot
2. **Preview** (höger) — From / To / Subject / body, radnavigering, **Edit template**
3. **Footer** — skickaknapp, skickmeny, **Upgrade to Pro** (gratis), inställningar, hjälp
## Sidebar-kontroller (exakta etiketter) [#sidebar-kontroller-exakta-etiketter]
* **New Template**
* **Template** (select) — platshållare `Select` eller `No templates found`
* **Recipient column** — alternativ som `A - Email`; tomt: `No valid email columns found.`
* **More options** — expanderar **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (på som standard)
* **Remove branding** (betald)
* **Daily quota** — kvarvarande antal som ”N left” och planrad ”Your plan sends up to TOTAL/day”
Gratiskonton ser också **Leave a 5★ review for +N/day free** och **Or upgrade your plan**. Se [Daily quota & reviews](/help/daily-quota-and-reviews).
## Skickkontroller i sidfot [#skickkontroller-i-sidfot]
| Kontroll | Etikett |
| --------------------- | ------------------------------------------------------------------------------------- |
| Primär knapp | **Send N email(s)** (eller **Send emails** när antalet är 0) |
| Skickmeny | **Send me a test email** |
| Skickmeny | **Schedule send** |
| Uppgradering (gratis) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Kugghjul | tooltip **Send pacing** |
| Hjälp | tooltip **Help** — öppnar checklistan i dialogen |
### Need help?-checklista [#need-help-checklista]
1. Välj en mall och mottagarkolumn
2. Förhandsgranska varje rad med pilarna
3. Skicka ett testmail till dig själv först
4. Klicka Send för att merga från kalkylbladet
Knappar: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (om tillgängligt) | **Close**
## Tomt kalkylblad [#tomt-kalkylblad]
Om MailG inte hittar någon giltig e-postkolumn:
* Titel: **No email address found in your sheet**
* Åtgärder: **Close** | **Fill with mock data**
Mock data skapar rubriker `Email`, `First Name`, `Last Name`, `Company` och kan skapa **My First Template**.
## Felskärmar [#felskärmar]
| Titel | När |
| --------------------------------- | ----------------------------- |
| **Could not reach the MailG API** | API- / nätverksfel |
| **Could not read your sheet** | Fel vid läsning av kalkylblad |
## Nästa [#nästa]
# Installera (/sv/getting-started/installation)
Två steg: installera tillägget och starta det från Sheets.
## Installera MailG [#installera-mailg]
1. Öppna [MailG-listningen på Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Klicka på **Install**.
3. Välj det Google-konto som ska äga installationen.
4. Granska behörigheterna och klicka på **Allow**.
Installationen tar vanligtvis under 15 sekunder. Du bör se en bekräftelse att tillägget installerades.
Om Marketplace-listningen ännu inte är live i din region, använd installationsknappen på [www.mailg.io](https://www.mailg.io) eller kontakta [contact@mailg.io](mailto:contact@mailg.io).
## Starta MailG i Google Sheets [#starta-mailg-i-google-sheets]
1. Öppna [Google Sheets](https://sheets.google.com) (uppdatera om Sheets redan var öppet).
2. Vänta några sekunder tills Extensions har laddats (ofta \~10–15 sekunder).
3. Gå till **Extensions → MailG for Gmail → 🚀 Start**.
Senare kan du köra **Extensions → MailG for Gmail → 🔄 Refresh Tracking** för att synka öppningsstatus utan att öppna hela dialogen.
## Installationsproblem [#installationsproblem]
Det här är vanliga Google Workspace-egenskaper, inte MailG-buggar:
### Jag ser aldrig popupen ”installed successfully” [#jag-ser-aldrig-popupen-installed-successfully]
Det händer ofta när flera Google-konton är inloggade och installationen inte använde det konto du förväntade dig.
**Lösning:** öppna ett privat/inkognito-fönster, logga in med endast målkontot och installera igen från Marketplace.
### MailG visas inte under Extensions [#mailg-visas-inte-under-extensions]
1. Uppdatera kalkylbladet.
2. Vänta cirka 10–15 sekunder tills tillägg har laddats.
3. Bekräfta att du är inloggad på samma Google-konto som installerade MailG.
4. Prova ett annat kalkylblad eller rensa webbläsarens cache om det fortfarande saknas.
## Självhostad / anpassade installationer [#självhostad--anpassade-installationer]
Marketplace-installationer är förkonfigurerade. Om du distribuerar MailG själv, ställ in Apps Script script properties:
| Property | Value |
| ------------- | -------------------------------------- |
| `APP_URL` | Offentlig HTTPS-URL till din MailG API |
| `APP_API_KEY` | Samma nyckel som API-servern |
Tillägget kan inte nå `localhost` från Googles servrar — använd en tunnel (Cloudflare Tunnel, ngrok, etc.) för lokal testning.
## Nästa [#nästa]
Fortsätt med [mail merge-handledningen](/getting-started/mail-merge-tutorial).
# Mail merge-handledning (/sv/getting-started/mail-merge-tutorial)
Den här genomgången matchar startdialogen **MailG for Gmail**.
## 1. Öppna MailG [#1-öppna-mailg]
**Extensions → MailG for Gmail → 🚀 Start**.
Om du ser **No email address found in your sheet**, lägg till riktiga e-postadresser eller klicka på **Fill with mock data** (skapar exempelrader och ofta **My First Template**). Se [Genomgång av startdialogen](/getting-started/start-dialog).
## 2. Skapa eller välj en mall [#2-skapa-eller-välj-en-mall]
1. Klicka på **New Template** (eller välj en befintlig under **Template**).
2. Ange **Template Name** och **Email Subject** (ämnet **merge-substitueras inte** ännu).
3. Skriv brödtexten och infoga [merge tags](/features/merge-tags) via **Merge Tag**.
4. **Save Template**.
Exempel på brödtext:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Konfigurera kampanjen [#3-konfigurera-kampanjen]
I sidopanelen:
1. Välj **Recipient column** (celler måste innehålla en giltig enskild e-postadress för att UI ska räkna dem).
2. Öppna **More options** för **CC**, **BCC**, **Sender name**, **Reply to address**.
3. Låt **Track emails** vara på (standard) om du vill ha öppningsstatus i kalkylbladet.
4. På en betald plan, aktivera **Remove branding**.
**Attachments** visas under **More options**, men filer bifogas inte vid sändning ännu. Länka till Drive eller en URL i brödtexten istället.
## 4. Förhandsgranska och testa [#4-förhandsgranska-och-testa]
1. Använd föregående/nästa-pilarna för att gå igenom rader.
2. Bekräfta **To:** och den mergade brödtexten (ämnet visar det råa mallämnet).
3. Skickmeny → **Send me a test email**.
4. Kontrollera inkorgen.
Detaljer: [Förhandsgranska och testa](/features/preview-and-test).
## 5. Skicka eller schemalägg [#5-skicka-eller-schemalägg]
* Primär knapp: **Send N email(s)** när mottagare räknas.
* Eller skickmeny → **Schedule send** → välj datum/tid → **Schedule Send**.
Busy overlays: `Starting your campaign…` / bekräftelse-toasts för schemaläggning.
MailG lägger till en kampanjkolumn som `🚀 My Template (yyyy/MM/dd)` eller `🗓️ …` vid schemaläggning.
Radstatusar:
| Status | Betydelse |
| ------------- | --------------------- |
| 🗓️ Scheduled | Väntar på start |
| ⏳ Sending… | Bearbetas |
| ✉️ Sent | Överlämnad till Gmail |
| ⚠️ Failed | Fel |
| 👀 Opened | Öppningspixel laddad |
## Vanliga misstag [#vanliga-misstag]
* Ämnes-taggar som förväntas personifieras — endast brödtext för tillfället
* Mottagarceller med flera kommaseparerade adresser — UI validerar **en** e-post per cell vid räkning
* Fel Google-konto jämfört med installationskontot
* Träffa daglig kvot — kontrollera **Daily quota** i sidopanelen
## Tips [#tips]
* Använd checklistan **Help** i sidfoten första gången
* Börja med 2–3 riktiga rader efter mock data
* Efter öppningar: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alert `Tracking info synced` (eller `No active campaigns`)
## Nästa [#nästa]
# Vad är MailG? (/sv/getting-started/what-is-mailg)
MailG förvandlar ett Google-kalkylblad till en mail merge-kampanj. Varje rad är en mottagare; kolumnrubriker blir merge tags (dubbla klammerparenteser runt rubriknamnet) i **email body**.
## Vad du kan göra [#vad-du-kan-göra]
* Skapa molnbaserade mallar (**Template Name**, **Email Subject**, rich body)
* Personifiera **body** med merge tags från kalkylbladsrubriker
* Förhandsgranska rader och **Send me a test email**
* Mappa **CC** / **BCC**, **Sender name**, **Reply to address**
* **Schedule send** eller skicka direkt
* **Track emails** med öppningsstatus i kalkylbladet
* Styr **Send pacing** på betalda planer
* **Remove branding** på betalda planer
* Följ **Daily quota** (och hämta eventuellt en gratis recensionsbonus)
## Så hänger det ihop [#så-hänger-det-ihop]
1. **Google Sheets-tillägg** — dialog under **MailG for Gmail**
2. **MailG API** — mallar, kampanjmetadata, öppningsspårning, rättigheter
3. **Ditt Gmail** — meddelanden skickas med `GmailApp` från det auktoriserade kontot
## Nästa steg [#nästa-steg]
# تواصل معنا (/ar/contact-us)
## الفوترة والاشتراكات [#الفوترة-والاشتراكات]
يمكنك إدارة معظم تغييرات الاشتراك من بوابة Stripe المرتبطة عبر [pricing](https://app.mailg.io/pricing?lang=ar). لطلبات الاسترداد أو مشاكل الدفع، راسلنا عبر البريد.
## أي شيء آخر [#أي-شيء-آخر]
راسل **[contact@mailg.io](mailto:contact@mailg.io)**.
نرد عادةً خلال يوم عمل واحد.
## روابط مفيدة [#روابط-مفيدة]
* [الموقع](https://www.mailg.io)
* [الأسعار](https://app.mailg.io/pricing?lang=ar)
* [الخصوصية](https://www.mailg.io/ar/privacy)
* [الشروط](https://www.mailg.io/ar/terms)
* [الصفحة الرئيسية للتوثيق](/)
# توثيق MailG (/ar)
MailG هي إضافة Google Sheets لدمج البريد مع Gmail. افتح **Extensions → MailG for Gmail → 🚀 Start**، أنشئ قالبًا، وعاين الصفوف، ثم أرسل أو جدول من حساب Gmail الخاص بك.
## ابدأ من هنا [#ابدأ-من-هنا]
## مواضيع شائعة [#مواضيع-شائعة]
## روابط مفيدة [#روابط-مفيدة]
* الموقع: [www.mailg.io](https://www.mailg.io)
* المستندات: [docs.mailg.io/ar](https://docs.mailg.io/ar)
* الأسعار: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=ar)
* التواصل: [contact@mailg.io](mailto:contact@mailg.io)
## لمساعدي الذكاء الاصطناعي / نماذج اللغة [#لمساعدي-الذكاء-الاصطناعي--نماذج-اللغة]
فضّل هذه النقاط النهائية المقروءة آليًا بدلًا من استخراج HTML:
* [Agents hub](https://www.mailg.io/ar/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# الأسئلة الشائعة (/ar/help/faq)
## التثبيت والفتح [#التثبيت-والفتح]
**كيف أفتح MailG؟**\
**Extensions → MailG for Gmail → 🚀 Start**. راجع [التثبيت](/getting-started/installation).
**No email address found in your sheet**\
أضف عناوين بريد إلى عمود، أو انقر **Fill with mock data**. راجع [جولة في نافذة البدء](/getting-started/start-dialog).
**Could not reach the MailG API**\
تحقق من الشبكة / عنوان API (استضافة ذاتية: `APP_URL` + `APP_API_KEY`). أعد فتح النافذة بعد الإصلاح.
## الإرسال [#الإرسال]
**رسائل البريد لا تُرسل**\
تحقق من **Daily quota**، أذونات Gmail، وأن خلايا **Recipient column** تحتوي على بريد واحد صالح لكل خلية. تظهر الإخفاقات كـ **⚠️ Failed**.
**هل تعمل وسوم الدمج في الموضوع؟**\
ليس بعد. يُدمَج **body** فقط. استخدم موضوعًا ثابتًا أو ضع التخصيص في النص. راجع [Merge tags](/features/merge-tags).
**هل يمكنني إرفاق ملفات؟**\
مُحدّد **Attachments** موجود ضمن **More options**، لكن الملفات لا تُرفَق عند الإرسال بعد. استخدم روابط.
**كيف أوقف حملة؟**\
[Stopping a campaign](/features/stopping-a-campaign) — امسح حالات الإرسال على الصفوف المتبقية.
**لماذا أنا محدود على Professional؟**\
قد يسمح MailG بما يصل إلى 1,500/يوم، لكن `@gmail.com` المجاني غالبًا ما يُحدّ بحدود Google قرب 500.
## التتبع [#التتبع]
**الجدول لا يزال يعرض Sent بعد فتح**\
**🔄 Refresh Tracking** → توقّع `Tracking info synced`. بعض عملاء البريد لا يحمّلون الصور أبدًا.
**النقرات؟**\
غير متتبعة. **Track emails** = فتحات فقط.
## الحصة والفوترة [#الحصة-والفوترة]
راجع [الحصة اليومية والمراجعات](/help/daily-quota-and-reviews) و[الحساب والفوترة](/help/account-and-billing).
**هل Schedule send مدفوع؟**\
لا. المدفوع يفتح حصصًا أعلى، أوضاع ضبط الإرسال، و**Remove branding**.
## استكشاف الأخطاء [#استكشاف-الأخطاء]
لإصلاحات خطوة بخطوة (أخطاء API، جدول فارغ، زر إرسال معطّل، صفوف فاشلة، التتبع، الحصة، عدم تأجيل الجدولة)، راجع [استكشاف الأخطاء](/help/troubleshooting).
رسائل toast شائعة قد تراها:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## ما زلت عالقًا؟ [#ما-زلت-عالقًا]
[استكشاف الأخطاء](/help/troubleshooting) · Docs [docs.mailg.io/ar](https://docs.mailg.io/ar) · [contact@mailg.io](mailto:contact@mailg.io)
# استكشاف الأخطاء (/ar/help/troubleshooting)
إصلاحات سريعة للرسائل والحالات التي تراها في الإضافة.
## النافذة لا تُحمَّل [#النافذة-لا-تُحمَّل]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
لم تتمكن نافذة البدء من الاتصال بخادم MailG.
* تأكد أنك متصل بالإنترنت
* تثبيت Marketplace: انتظر لحظة وأعد فتح **🚀 Start**
* استضافة ذاتية: تحقق من خصائص Apps Script `APP_URL` (HTTPS عام) و`APP_API_KEY`
* لا يمكن للإضافة استخدام `localhost` — استخدم نفقًا لاختبار API محليًا
### Could not read your sheet [#could-not-read-your-sheet]
فشل MailG في قراءة الجدول النشط.
* تأكد أن تبويب جدول مفتوح (وليس محرر Apps Script فقط)
* أعد تحميل الجدول، ثم أعد فتح النافذة
* تأكد أن لديك صلاحية تحرير الملف
### Loading… لا ينتهي أبدًا [#loading-لا-ينتهي-أبدًا]
أغلق النافذة، حدّث Sheets، انتظر \~15 ثانية لـ Extensions، ثم **🚀 Start** مجددًا.
## جدول فارغ [#جدول-فارغ]
**No email address found in your sheet**
يحتاج MailG إلى عمود واحد على الأقل بعناوين بريد صالحة.
* أضف عناوين بريد تحت رأس، أو انقر **Fill with mock data**
* البيانات الوهمية تنشئ `Email`، `First Name`، `Last Name`، `Company` وغالبًا **My First Template**
راجع [جولة في نافذة البدء](/getting-started/start-dialog).
## القوالب [#القوالب]
* إنشاء: `Creating Template...` → `Template created successfully!` أو `Failed to create template! Try again later.`
* تحديث: `Updating template...`
* فشل الحذف: `Failed to delete template. Try again later`
راجع [Templates](/features/templates).
## مشاكل الإرسال [#مشاكل-الإرسال]
### زر الإرسال معطّل / Send emails بدون عدد [#زر-الإرسال-معطّل--send-emails-بدون-عدد]
* اختر **Template**
* اختر **Recipient column** بعناوين بريد **فردية** صالحة لكل خلية
* رسائل toast وقائية قد تراها: `Configure your recipient column first`، `Select a template first.`، `No valid recipient emails found in the selected column.`
### فشل بدء الحملة [#فشل-بدء-الحملة]
Toast: `Failed to create campaign. Please try again.`
* أعد المحاولة مرة
* تحقق أن **Daily quota** ليست 0
* تأكد من اتصال API (انظر أعلاه)
### الصفوف تعرض ⚠️ Failed [#الصفوف-تعرض-️-failed]
واجه هذا الصف خطأ إرسال (عنوان غير صالح، رفض Gmail، حصة مؤقتة، إلخ). صحّح البيانات وابدأ حملة جديدة للصفوف المتبقية، أو راجع [Stopping a campaign](/features/stopping-a-campaign).
### فشل البريد التجريبي [#فشل-البريد-التجريبي]
* `Configure your preview first` — اختر قالبًا + مستلمًا حتى تحتوي المعاينة على To
* `Failed to send test email. Please check your email settings.` — أعد تفويض Gmail إن لزم، ثم أعد المحاولة
## التتبع [#التتبع]
* الفتحات تتطلب تحميل المستلم للصور البعيدة
* شغّل **🔄 Refresh Tracking** — توقّع `Tracking info synced` أو `No active campaigns`
* الحالة **👀 Opened** تظهر فقط عند تحميل البكسل
راجع [Email tracking](/features/email-tracking).
## الحصة والعلامة التجارية [#الحصة-والعلامة-التجارية]
* **N left** في الشريط الجانبي = `min(المتبقي من MailG، المتبقي من Gmail)`
* `@gmail.com` المجاني غالبًا ما يُحدّ بحدود Google قرب 500/يوم حتى على Professional
* العلامة المائية ما زالت موجودة بعد الدفع → بريد الدفع يجب أن يطابق حساب Sheets؛ أعد فتح النافذة
راجع [الحصة اليومية والمراجعات](/help/daily-quota-and-reviews) و[Remove branding](/features/remove-branding).
## الجدولة لم تؤجّل [#الجدولة-لم-تؤجّل]
الأوقات أقل من \~**15 ثانية** في المستقبل تُعامَل كإرسال **فوري** (عمود 🚀)، وليس جدولة مؤجّلة 🗓️. اختر وقتًا أبعد في المستقبل.
## ما زلت عالقًا؟ [#ما-زلت-عالقًا]
FAQ كاملة: [الأسئلة الشائعة](/help/faq) · بريد [contact@mailg.io](mailto:contact@mailg.io) · الموقع [app.mailg.io/help](https://www.mailg.io/ar/help)
# الحصة اليومية والمراجعات (/ar/help/daily-quota-and-reviews)
يعرض الشريط الجانبي Root سعة الإرسال عند تحميل بيانات الحساب.
## كتلة Daily quota [#كتلة-daily-quota]
واجهة المستخدم الدقيقة:
* التسمية: **Daily quota**
* المتبقي: **N left**
* سطر الخطة: **Your plan sends up to TOTAL/day**
**Remaining** هو الحد الأدنى بين:
1. المتبقي من خطة MailG لليوم
2. حصة إرسال Gmail المتبقية للحساب
لذا قد تُحدّ بحدود Gmail حتى عندما يظهر MailG هامشًا نظريًا. راجع أيضًا [الحساب والفوترة](/help/account-and-billing).
## دعوات الخطة المجانية [#دعوات-الخطة-المجانية]
عندما لا تكون مشتركًا، قد يعرض الشريط الجانبي:
* **Leave a 5★ review for +N/day free** (المكافأة الافتراضية **+50/day** عندما لا يحدد API غير ذلك)
* **Or upgrade your plan**
النقر على دعوة المراجعة يفتح **Free Quota upgrade**:
* العنوان: **Free Quota upgrade**
* النص: اترك مراجعة 5 نجوم للحصول على ترقية حصة مجانية بـ **+N emails/day**
* الأزرار: **Not now** | **Leave a 5★ review**
إذا لم يُضبط رابط المراجعة، يبقى **Leave a 5★ review** معطّلًا — استخدم **Upgrade to Pro** / الأسعار بدلًا من ذلك.
## الترقية إلى Pro [#الترقية-إلى-pro]
زر التذييل (حسابات مجانية): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
يتوافق ذلك مع ما تفتحه الخطط المدفوعة في المنتج اليوم.
## ذات صلة [#ذات-صلة]
* [Remove branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [الأسئلة الشائعة](/help/faq)
# الحساب والفوترة (/ar/help/account-and-billing)
فوترة MailG مرتبطة بـ**بريد حساب Google** في Sheets. ادفع دائمًا بنفس العنوان حتى تُفعَّل الحصص في الإضافة.
## الخطط والحصص اليومية [#الخطط-والحصص-اليومية]
| الخطة | الحصة اليومية | ملاحظات |
| ------------ | ------------- | ------------------------------ |
| Free | 50 | دمج أساسي، تتبع الفتح، الجدولة |
| Personal | 250 | خطة شائعة للقوائم المتنامية |
| Professional | 1,500 | أعلى حصة متكررة |
| Lifetime | 1,500 | شراء لمرة واحدة |
الأسعار والفترات مدرجة على [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=ar) (EUR و USD).
الامتيازات المدفوعة تفتح أيضًا:
* [Send pacing](/features/send-pacing) غير الافتراضي (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
حجم الإرسال الفعلي هو `min(حصة MailG اليومية، حصة Gmail المتبقية)`.
## كيفية الترقية [#كيفية-الترقية]
1. افتح [الأسعار](https://app.mailg.io/pricing?lang=ar) (مرتبط أيضًا من الإضافة عبر **Upgrade to Pro**).
2. اختر خطة وأكمل Stripe Checkout ببريد Google في Sheets.
3. أعد فتح MailG في Sheets حتى يلتقط تحديث الحساب الحد الجديد.
## إلغاء أو تعديل الاشتراك [#إلغاء-أو-تعديل-الاشتراك]
يمكنك إلغاء أو تغيير اشتراكك من بوابة عميل Stripe المرتبطة بتدفق الاشتراك / الأسعار.
* إذا ألغيت منتصف الدورة، تبقى ميزات Premium نشطة حتى نهاية الفترة المدفوعة
* لن تُفرض عليك رسوم مرة أخرى بعد سريان الإلغاء
## الاسترداد [#الاسترداد]
إذا ألغيت اشتراك Premium خلال **30 يومًا** من الشراء، يمكنك طلب استرداد كامل بالبريد إلى [contact@mailg.io](mailto:contact@mailg.io).
## الفواتير [#الفواتير]
يرسل Stripe إيصالات بالبريد للمدفوعات الناجحة. يمكنك أيضًا تنزيل الفواتير من بوابة عميل Stripe المستخدمة لإدارة الاشتراك.
## مقتطفات FAQ [#مقتطفات-faq]
**هل MailG مضمّن في Google Workspace؟**\
لا. MailG مستقل عن Google. اشتراك Workspace لا يشمل MailG.
**ما طرق الدفع المقبولة؟**\
البطاقات الرئيسية، Google Pay، و Apple Pay عبر Stripe. PayPal غير مدعوم.
**دفعت لكن ما زلت أرى الحد المجاني / العلامة المائية**\
تقريبًا دائمًا عدم تطابق البريد. تأكد أن بريد الدفع = بريد حساب Sheets، ثم أعد فتح الإضافة. إذا استمر، تواصل مع الدعم مع كلا البريدين.
**لماذا Gmail المجاني محدود بحوالي 500 بريد يوميًا؟**\
يسمح MailG Professional بما يصل إلى 1,500 بريد يوميًا، لكن Google نفسها تحدّ حسابات `@gmail.com` المجانية بحوالي 500 إرسال يوميًا. حسابات Google Workspace يمكن أن تصل أعلى. هذا حد مزوّد Gmail، وليس حد MailG.
# جدولة الحملات (/ar/features/campaign-scheduling)
استخدم **Schedule send** عندما تريد أن يبدأ MailG لاحقًا. متاح في الخطط المجانية والمدفوعة.
## كيفية الجدولة [#كيفية-الجدولة]
1. اضبط القالب والمستلمين حتى يُفعَّل زر الإرسال.
2. افتح قائمة الإرسال (chevron) → **Schedule send**.
3. عنوان النافذة: **Schedule send**
4. الوصف: `Pick date & time to schedule sending`
5. سطر الملخص: جدولة N رسائل لتُرسل بدءًا من التاريخ/الوقت المختار
6. استخدم منتقي التاريخ مع **Hour** / **Minute** (placeholders `Hour`, `Min`).
7. أكّد بـ **Schedule Send** (أو **Cancel**).
الاقتراح الافتراضي حوالي **60 دقيقة** للأمام، مقرّبًا لأقرب خطوة **15 دقيقة**.
## فوري مقابل مجدول [#فوري-مقابل-مجدول]
الأوقات الأقل من حوالي **15 ثانية** للأمام تُعامَل كإرسال **فوري** (رأس عمود 🚀)، وليس جدولة مؤجّلة 🗓️. اختر وقتًا أبعد في المستقبل إن احتجت إرسالًا مؤجّلًا.
Toasts التحقق: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Toast نجاح: تمت جدولة الحملة؛ ستبدأ N رسائل في الوقت المختار.
## عمود الجدول [#عمود-الجدول]
تنشئ الحملات المجدولة رأس عمود مثل:
```text
🗓️ Template name (yyyy/MM/dd)
```
الإرسالات الفورية تستخدم 🚀 بدل 🗓️.
تبدأ الصفوف كـ **🗓️ Scheduled**، ثم تنتقل إلى **⏳ Sending…** عند تشغيل الطابور.
## بعد الجدولة [#بعد-الجدولة]
* أبقِ جدول البيانات متاحًا لحساب Google الذي يملك الملحق
* التتبع وإيقاع الإرسال يظلان ساريين عند بدء الإرسال
* لا توجد واجهة **Manage Schedule** — راجع [إيقاف حملة](/features/stopping-a-campaign)
## انظر أيضًا [#انظر-أيضًا]
* [المعاينة والاختبار](/features/preview-and-test)
* [إيقاع الإرسال](/features/send-pacing)
# مستلمون متعددون (/ar/features/multiple-recipients)
يمكنك إضافة مستلمين بنسخة كربونية لكل صف بأعمدة جدول مخصّصة.
## عمود المستلم (**To**) [#عمود-المستلم-to]
اختر **Recipient column** في الشريط الجانبي.
لعداد زر الإرسال والتحقق من الأعمدة، يعتبر MailG الخلية صالحة عندما تكون **عنوان بريد واحد**. فضّل عنوان **To** أساسيًا واحدًا لكل صف.
## أعمدة CC وBCC [#أعمدة-cc-وbcc]
1. أضف أعمدة في الجدول (مثلًا `CC` و`BCC`).
2. ضع بريدًا (أو قائمة يقبلها Gmail) في الخلية.
3. افتح **More options** واربط **CC** / **BCC**.
4. عند الإرسال، تُمرَّر تلك القيم إلى Gmail.
تعرض لوحة المعاينة **From** و**To** و**Subject** وbody فقط. **لا** تعرض أسطر CC/BCC حتى عند الربط. تأكّد بـ **Send me a test email** إن احتجت التحقق من تسليم CC/BCC.
## الحصص: MailG مقابل Gmail [#الحصص-mailg-مقابل-gmail]
* **حصة MailG اليومية** تعد **صفوف الحملة** المعالَجة.
* **حدود إرسال Gmail** تعد **المستلمين** (عناوين To + CC + BCC التي يقبلها Gmail في ذلك الإرسال).
قد تصل إلى حد Gmail بينما تبقى حصة MailG.
## نصائح [#نصائح]
* فضّل **BCC** عندما لا ينبغي للمستلمين رؤية بعضهم
* اترك CC/BCC غير مربوطة عند عدم الاستخدام
* تحقّق من العناوين قبل إرسال كبير
# Attachments (/ar/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# نظرة عامة على الميزات (/ar/features/features-overview)
ما يدعمه الملحق اليوم:
| الميزة | التوثيق |
| ---------------------------------------- | --------------------------------------------------------- |
| نافذة البدء / جدول فارغ / بيانات تجريبية | [جولة في نافذة البدء](/getting-started/start-dialog) |
| القوالب (إنشاء / إدارة / تعديل / حذف) | [القوالب](/features/templates) |
| Merge tags في **body** | [Merge tags](/features/merge-tags) |
| شريط أدوات النص المنسّق | [رسائل بريد منسّقة](/features/rich-text-emails) |
| روابط (بدون تضمين صور) | [الصور](/features/images) |
| معاينة + بريد تجريبي | [المعاينة والاختبار](/features/preview-and-test) |
| **Schedule send** | [جدولة الحملة](/features/campaign-scheduling) |
| **Send pacing** (مدفوع) | [إيقاع الإرسال](/features/send-pacing) |
| أعمدة CC / BCC | [مستلمون متعددون](/features/multiple-recipients) |
| **Track emails** | [تتبع البريد](/features/email-tracking) |
| **Sender name** و reply-to | [مرسل مخصّص](/features/customized-sender) |
| **Remove branding** (مدفوع) | [إزالة العلامة التجارية](/features/remove-branding) |
| إيقاف الصفوف المتبقية | [إيقاف حملة](/features/stopping-a-campaign) |
| الحصة اليومية + مكافأة المراجعة | [الحصة اليومية والمراجعات](/help/daily-quota-and-reviews) |
## مجاني مقابل مدفوع [#مجاني-مقابل-مدفوع]
الخطة المدفوعة تفتح:
* [إيقاع إرسال](/features/send-pacing) غير الافتراضي
* [إزالة العلامة التجارية](/features/remove-branding)
* [حصص يومية](/help/account-and-billing) أعلى
**Schedule send** و**Track emails** وأدوات القوالب تعمل بدون ترقية مدفوعة.
## فجوات معروفة (بصراحة) [#فجوات-معروفة-بصراحة]
| الموضوع | الحالة في المنتج |
| ------------------------------- | ------------------------------------------- |
| Merge tags في الموضوع | غير مطبّقة عند الإرسال — body فقط |
| عمود Attachments | واجهة فقط — لا يُرفق عند الإرسال |
| تضمين الصور | لا يوجد عنصر تحكم في المحرّر — استخدم روابط |
| أسطر CC/BCC في المعاينة | غير معروضة في واجهة المعاينة |
| **Manage Schedule** / **Pause** | غير متوفر — حل بديل عبر الحالات |
## لاحقًا [#لاحقًا]
روابط إلغاء الاشتراك، تتبع النقرات، مقاعد فريق مشتركة، وواجهة مخصّصة لإدارة الحملات عند توفرها.
# تتبع البريد (/ar/features/email-tracking)
يمكن لـ MailG تسجيل الفتحات ببكسل صغير غير مرئي.
## تفعيل التتبع [#تفعيل-التتبع]
في الشريط الجانبي، اترك **Track emails** مفعّلًا (الافتراضي مفعّل للمهام الجديدة).
التلميح: `Track emails opened with a tiny pixel`
أيقونة المساعدة تفتح **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
الزر: **Got it**
## حالات الجدول [#حالات-الجدول]
| الحالة | المعنى |
| ------------- | -------------------------- |
| 🗓️ Scheduled | في انتظار بدء الجدولة |
| ⏳ Sending… | قيد المعالجة حاليًا |
| ✉️ Sent | سُلّمت إلى Gmail لذلك الصف |
| ⚠️ Failed | خطأ إرسال لذلك الصف |
| 👀 Opened | تم تحميل بكسل الفتح |
رؤوس أعمدة الحملة تبدو مثل `🚀 Template name (yyyy/MM/dd)` أو `🗓️ …` عند الجدولة.
## تحديث التتبع [#تحديث-التتبع]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
تنبيهات Apps Script:
* `Tracking info synced`
* `No active campaigns`
## القيود [#القيود]
* يجب أن يحمّل العميل الصور البعيدة
* وكلاء الخصوصية قد يخفون الفتحات
* فتحات فقط — وليس نقرات الروابط
## انظر أيضًا [#انظر-أيضًا]
* [جدولة الحملة](/features/campaign-scheduling)
* [الأسئلة الشائعة](/help/faq)
# وسوم الدمج (/ar/features/merge-tags)
تتيح merge tags لكل مستلم **body** مخصّصًا. الوسم هو **رأس العمود بالضبط** محاطًا بأقواس معقوفة مزدوجة.
## الصيغة [#الصيغة]
إذا كان لديك عمود باسم `First Name`، استخدم:
```text
{{First Name}}
```
مثال body:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## أين تعمل merge tags اليوم [#أين-تعمل-merge-tags-اليوم]
| الحقل | يُدمَج عند الإرسال؟ |
| --------------- | ------------------------------------ |
| Email body | **نعم** — تُحقَن المتغيرات لكل صف |
| Email subject | **لا** — يُرسل الموضوع كما في القالب |
| Preview body | **نعم** — للصف النشط |
| Preview subject | **لا** — يعرض موضوع القالب الخام |
ضع التخصيص في body حتى يتوفر دمج الموضوع.
## إدراج الوسوم [#إدراج-الوسوم]
في شريط أدوات المحرّر، افتح **Merge Tag**. يعرض رؤوس الأعمدة من الجدول النشط. الحالة الفارغة: `No sheet columns found`.
النص المُدرَج يستخدم أقواسًا معقوفة مزدوجة حول اسم العمود.
## قواعد عملية [#قواعد-عملية]
* الرؤوس حسّاسة لحالة الأحرف (`Name` ≠ `name`)
* الخلايا الفارغة تُدرَج كسلاسل فارغة
* يمكنك إعادة استخدام نفس الوسم عدة مرات في body
* المستلم / CC / BCC يُختارون تحت **More options**، وليس عبر merge tags
## التالي [#التالي]
راجع [رسائل بريد منسّقة](/features/rich-text-emails) و[المعاينة والاختبار](/features/preview-and-test).
# بريد بتنسيق غني (/ar/features/rich-text-emails)
تستخدم قوالب MailG محرّر TipTap للنص المنسّق. HTML الذي ينتجه هو ما يُسلّمه Gmail.
Placeholder لـ body: `Write your email…`
## جرد شريط الأدوات (واجهة دقيقة) [#جرد-شريط-الأدوات-واجهة-دقيقة]
| المجموعة | عناصر التحكم |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (إعدادات مسبقة في الشريط) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | عينات ألوان + منتقي ألوان أصلي + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — placeholder لحقل URL `https://example.com`، ثم **Apply** (وإلغاء الربط) |
| History | **Undo**, **Redo** |
## غير موجود في المحرّر [#غير-موجود-في-المحرّر]
ميزات TipTap هذه معطّلة / غير متوفرة:
* عناوين، كود، كتلة كود، اقتباس، خط أفقي
* إدراج صورة / منتقي Drive — راجع [الصور](/features/images)
## الروابط التشعبية [#الروابط-التشعبية]
استخدم **Insert link** للـ URL والنص الظاهر. فضّل نص رابط واضحًا على عناوين URL خام.
## نصائح [#نصائح]
* استخدم **Merge Tag** بدل كتابة الأقواس يدويًا
* عاين عدة صفوف قبل الإرسال — راجع [المعاينة والاختبار](/features/preview-and-test)
* تجنّب لصق ترميز Word/Docs ضخم؛ أعد تنسيق النص في MailG لـ HTML أنظف
# إزالة علامة MailG (/ar/features/remove-branding)
قد تتضمن الحملات المجانية علامة MailG صغيرة في تذييل البريد. يمكن للمشتركين المدفوعين إيقافها.
## كيفية إزالة العلامة التجارية [#كيفية-إزالة-العلامة-التجارية]
1. تأكّد من خطة مدفوعة نشطة (Personal أو Professional أو Lifetime).
2. افتح الشريط الجانبي للحملة.
3. فعّل **Remove branding**.
4. عاين صفًا للتأكد من اختفاء العلامة المائية، ثم أرسل.
إن ظلّت العلامة بعد الدفع:
* تأكّد أن الدفع استخدم **نفس البريد** كحساب Google Sheets
* أعد فتح الملحق ليحدّث الصلاحيات من API
* تواصل مع [contact@mailg.io](mailto:contact@mailg.io) مع بريد حساب Google
راجع [الحساب والفوترة](/help/account-and-billing).
# الصور (/ar/features/images)
لا يحتوي محرّر MailG على **زر إدراج صورة** ولا منتقي وسائط Google Drive. امتداد Image في TipTap غير مفعّل.
## ما يمكنك فعله اليوم [#ما-يمكنك-فعله-اليوم]
استخدم **Insert link** في شريط الأدوات:
1. استضِف الصورة (أو الملف) على URL عام، أو شارك رابط Drive.
2. حدّد نصًا (أو ضع المؤشر) → **Insert link**.
3. الصق الـ URL (placeholder `https://example.com`) → **Apply**.
يفتح المستلمون الرابط لعرض الصورة أو الملف. المحرّر لا يُضمّن وسوم `![]()
` نيابةً عنك.
## نصائح [#نصائح]
* فضّل ملفات صغيرة ونص رابط واضح («View screenshot»)
* الروابط التي تتطلب تسجيل دخول ستفشل للمستلمين
* تأكّد بـ **Send me a test email**
## لاحقًا [#لاحقًا]
قد يُضاف لاحقًا تضمين صور / منتقي Drive من الدرجة الأولى. حتى ذلك الحين، الروابط التشعبية هي المسار المدعوم.
# القوالب (/ar/features/templates)
تخزّن القوالب الموضوع و**body** المنسّق اللذين تعيد استخدامهما عبر الحملات. تُحفظ عبر MailG API لحساب Google الخاص بك.
## إنشاء قالب [#إنشاء-قالب]
1. في الشاشة الرئيسية، انقر **New Template**.
2. املأ:
* **Template Name**
* **Email Subject**
* **Body** (محرّر منسّق — راجع [رسائل بريد منسّقة](/features/rich-text-emails))
3. انقر **Save Template** (يعرض **Saving...** أثناء الحفظ).
Toasts:
* تحميل: `Creating Template...`
* نجاح: `Template created successfully!`
* خطأ: `Failed to create template! Try again later.`
قالب تجريبي من **Fill with mock data**: الاسم **My First Template**، الموضوع `I found a mail merge tool for Gmail`.
## إدارة القوالب [#إدارة-القوالب]
افتح أيقونة القالب بجانب اختيار القالب (تلميح **Manage templates**).
أعمدة الجدول:
| العمود | المحتوى |
| ----------------- | ------------- |
| **Name** | اسم القالب |
| **Email Subject** | سطر الموضوع |
| **Created At** | تاريخ الإنشاء |
| **Actions** | قائمة الصف |
قائمة الصف: **Edit** | **Delete**
التذييل: **Back**
Toasts الحذف: deleting template NAME → template NAME deleted successfully (أو رسالة فشل).
## تعديل قالب [#تعديل-قالب]
افتح **Edit** من الإدارة، أو انقر **Edit template** في شريط أدوات المعاينة.
نفس الحقول كما في الإنشاء. **Save Template** يحدّث القالب.
يعرض مسار التحديث toast تحميل (`Updating template...`). ابقَ في النموذج حتى ينتهي، ثم استخدم **Cancel** أو **Back** إن لم تُعاد تلقائيًا.
## الموضوع مقابل body [#الموضوع-مقابل-body]
* **Body** يدعم [merge tags](/features/merge-tags) — تُحقَن لكل صف عند الإرسال.
* **Email Subject** يُرسل كما هو مخزّن اليوم (merge tags في الموضوع **لا** تُستبدَل بعد). ضع التخصيص في body، أو استخدم موضوعًا ثابتًا.
## انظر أيضًا [#انظر-أيضًا]
* [المعاينة والاختبار](/features/preview-and-test)
* [جولة في نافذة البدء](/getting-started/start-dialog)
# معاينة واختبار (/ar/features/preview-and-test)
تعرض لوحة المعاينة (يمين نافذة البدء الرئيسية) شكل الرسالة للصف النشط في الجدول.
## ما تعرضه المعاينة [#ما-تعرضه-المعاينة]
| الحقل | المحتوى |
| ------------ | ------------------------------------------------------------------------- |
| **From:** | بريد حساب Google المسجّل |
| **To:** | القيمة من **Recipient column** للصف النشط، أو `Select a recipient column` |
| **Subject:** | موضوع القالب كما هو مخزّن (بدون استبدال merge) |
| Body | body القالب مع تطبيق merge tags لذلك الصف |
إذا كان **Remove branding** معطّلًا، تتضمن المعاينة تذييل العلامة المائية MailG (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## ما لا يُعرض [#ما-لا-يُعرض]
* أسطر **CC** / **BCC** لا تُعرض في واجهة المعاينة (حتى عند ربطها تحت **More options**). تُطبَّق عند الإرسال.
* قيم عمود المرفقات غير معروضة في المعاينة.
## التنقل بين الصفوف [#التنقل-بين-الصفوف]
شريط أدوات المعاينة:
* **Edit template** — يفتح شاشة تحديث القالب
* **Previous recipient** / **Next recipient** — التنقل بين صفوف البيانات (قد تتضمن التلميحات رقم صف الجدول؛ الرأس صف 1، فأول جهة اتصال صف 2)
## أرسل لي رسالة اختبار [#أرسل-لي-رسالة-اختبار]
1. اضبط القالب + **Recipient column** حتى تكون المعاينة صالحة.
2. افتح قائمة الإرسال (chevron) → **Send me a test email**.
3. طبقة مشغولة: `Sending test email…`
4. toast نجاح: `Test email sent successfully. Check your inbox.`
5. toast فشل: `Failed to send test email. Please check your email settings.`
6. حماية إن كانت المعاينة ناقصة: `Configure your preview first`
يذهب الاختبار إلى صندوق وارد **حساب Google** الخاص بك، باستخدام body مدمج للصف النشط في المعاينة.
## نصائح [#نصائح]
* مرّ على عدة صفوف بالأسهم قبل إرسال كامل
* تأكّد من العلامة التجارية / عدمها في المعاينة
* اختبر دائمًا قبل **Schedule send** أو **Send N email(s)** الكبير
## انظر أيضًا [#انظر-أيضًا]
* [Merge tags](/features/merge-tags)
* [دليل دمج البريد](/getting-started/mail-merge-tutorial)
# إيقاع الإرسال (/ar/features/send-pacing)
يضيف **Send pacing** تأخيرًا بين الرسائل حتى لا تغادر حملة كبيرة حسابك دفعة واحدة.
**Steady pace** و**Jittered gaps** يتطلبان اشتراك MailG مدفوعًا نشطًا. الحسابات المجانية تستخدم **Burst send** فقط.
## أين تُضبط [#أين-تُضبط]
افتح ترس التذييل (تلميح **Send pacing**). عنوان الشاشة: **Send pacing**.
تحت **Dispatch mode**، اختر كيف تُباعد الرسائل. **Gap between emails** بال**ثواني** (0–60). يرى الحساب المجاني **Pro features** والنص المقفل: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
الافتراضي للمهام الجديدة: **Burst send**، فجوة **10s** (تُتجاهَل الفجوة حتى تغادر burst).
## الأوضاع [#الأوضاع]
| الوضع (تسمية الواجهة) | السلوك |
| ------------------------ | ---------------------------------------------- |
| **Burst send** (افتراضي) | إرسال بأسرع ما تسمح الحصص |
| **Steady pace** | انتظار فجوة ثابتة بين كل رسالة |
| **Jittered gaps** | انتظار فجوة عشوائية بين 0 والحد الأقصى المختار |
## لماذا تستخدم الإيقاع [#لماذا-تستخدم-الإيقاع]
* تقليل احتمال أن تبدو دفعة مفاجئة لمزوّدي البريد
* توزيع قائمة طويلة على نافذة إرسال أهدأ
* البقاء ضمن حدود راحة Gmail لنوع حسابك
## ملاحظات [#ملاحظات]
* الإيقاع إعداد حملة يُخزَّن مع المهمة — الإرسالات الجديدة تستخدم الإعداد الحالي
* فجوة طويلة على قائمة كبيرة تزيد مدة الحملة الإجمالية بشكل ملحوظ
* سرعتك الفعلية ما زالت محدودة بحصة MailG اليومية **و** حصة Gmail المتبقية
* أدوات منافسة أحيانًا تعبّر عن التأخير بالدقائق — MailG يستخدم **الثواني**
## انظر أيضًا [#انظر-أيضًا]
* [إيقاف حملة](/features/stopping-a-campaign) إن كانت الفجوة مرتفعة جدًا أثناء التشغيل
* [الحساب والفوترة](/help/account-and-billing)
# إيقاف حملة (/ar/features/stopping-a-campaign)
MailG لا يوفّر بعد شاشة **Manage Schedule** أو **Abort** أو **Pause** مخصّصة كبعض المنافسين. يمكنك مع ذلك إيقاف الصفوف **المتبقية** من الإرسال.
## كيف يقرّر الإرسال ما يُعالَج [#كيف-يقرّر-الإرسال-ما-يُعالَج]
حلقة الإرسال تعالج فقط الصفوف التي حالة عمود الحملة فيها ما زالت قابلة للإرسال:
* ⏳ Sending… / `Pending...` قديم
* 🗓️ Scheduled / `Scheduled` قديم
الصفوف المعلّمة مسبقًا **✉️ Sent** أو **⚠️ Failed** أو **👀 Opened** تُتخطّى.
## إيقاف الصفوف المتبقية (حل بديل صريح) [#إيقاف-الصفوف-المتبقية-حل-بديل-صريح]
تحرّك بسرعة على حملة كبيرة:
1. افتح جدول البيانات.
2. في عمود حالة الحملة، امسح أو غيّر الحالة على الصفوف التي **لا** ينبغي أن تُرسَل (مثلًا احذف قيمة الخلية، أو ضع تسمية غير قابلة للإرسال مثل `Stopped`).
3. اترك صفوف **✉️ Sent** كما هي — تلك الرسائل خرجت بالفعل.
الصفوف التي تمسحها/تغيّرها لن تطابق الحالات القابلة للإرسال، فيتخطّاها الطابور في الجولة التالية.
رسائل Gmail التي غادرت الحساب لا يمكن إلغاء إرسالها عبر MailG. الإيقاف يحمي فقط الصفوف التي لم تُعالَج بعد.
## حملات مجدولة لم تبدأ [#حملات-مجدولة-لم-تبدأ]
إذا كان كل صف ما زال **🗓️ Scheduled** ولم يحن وقت البدء، مسح تلك الحالات (أو عمود الحملة) يمنع الطابور من التقاطها عند حلول الوقت.
إن لم تكن متأكدًا، تواصل مع [contact@mailg.io](mailto:contact@mailg.io) مع URL الجدول وتفاصيل الحملة.
## انظر أيضًا [#انظر-أيضًا]
* [جدولة الحملة](/features/campaign-scheduling)
* [إيقاع الإرسال](/features/send-pacing)
* [الأسئلة الشائعة](/help/faq)
# مرسل مخصص (/ar/features/customized-sender)
افتراضيًا، يرسل Gmail من حساب Google الذي فوّض MailG. يمكنك مع ذلك تخصيص ظهور اسمك وأين تذهب الردود.
## اسم المرسل [#اسم-المرسل]
1. افتح **More options** في الشريط الجانبي للحملة.
2. اضبط **Sender name** (placeholder `John Doe (Optional)`).
3. يرى المستلمون ذلك الاسم الظاهر في صندوق الوارد (وفق قواعد عرض Gmail المعتادة).
## عنوان الرد [#عنوان-الرد]
اضبط **Reply to address** (placeholder `john@doe.com (Optional)`) إن كان ينبغي أن تذهب الردود إلى غير حساب الإرسال.
## ملاحظات [#ملاحظات]
* عنوان **From** الأساسي يبقى حساب Gmail المصرّح — لا يمكن انتحال صندوق بريد آخر
* عناوين reply-to غير صالحة قد تسبب مشاكل تسليم أو رد — استخدم صندوقًا تتحكم به
* المعاينة تعرض **From:** كبريدك المسجّل؛ تأكّد من reply-to بـ **Send me a test email**
* راجع [المعاينة والاختبار](/features/preview-and-test)
# جولة في نافذة البدء (/ar/getting-started/start-dialog)
افتح الإضافة عبر **Extensions → MailG for Gmail → 🚀 Start**. تُفتح نافذة 900×600 بعنوان **MailG for Gmail**.
## الشاشات [#الشاشات]
| الشاشة | كيف تصل إليها | الغرض |
| ------------------ | -------------------------------------------- | -------------------------------------- |
| Root (composer) | الافتراضي بعد التحميل | اختر القالب + المستلمين، معاينة، إرسال |
| Create template | **New Template** | الاسم، الموضوع، النص |
| Manage templates | أيقونة القالب (tooltip **Manage templates**) | قائمة، تحرير، حذف |
| Update template | **Edit template** أو **Edit** في الصف | تحرير قالب موجود |
| Settings | ترس التذييل (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | لا يوجد عمود بريد صالح | مطالبة بإضافة جهات اتصال أو mock data |
| API / sheet errors | فشل التحميل | إرشادات إعادة المحاولة |
## تخطيط Root [#تخطيط-root]
ثلاث مناطق:
1. **Sidebar** (يسار) — القالب، عمود المستلم، **More options**، التتبع، العلامة التجارية، الحصة
2. **Preview** (يمين) — From / To / Subject / body، التنقل بين الصفوف، **Edit template**
3. **Footer** — زر الإرسال، قائمة الإرسال، **Upgrade to Pro** (مجاني)، الإعدادات، المساعدة
## عناصر Sidebar (التسميات الدقيقة) [#عناصر-sidebar-التسميات-الدقيقة]
* **New Template**
* **Template** (select) — placeholder `Select` أو `No templates found`
* **Recipient column** — خيارات مثل `A - Email`؛ فارغ: `No valid email columns found.`
* **More options** — يوسّع **Attachments**، **CC**، **BCC**، **Sender name**، **Reply to address**
* **Track emails** (مفعّل افتراضيًا)
* **Remove branding** (مدفوع)
* **Daily quota** — العدد المتبقي كـ «N left» وسطر الخطة «Your plan sends up to TOTAL/day»
الحسابات المجانية ترى أيضًا **Leave a 5★ review for +N/day free** و**Or upgrade your plan**. راجع [Daily quota & reviews](/help/daily-quota-and-reviews).
## عناصر الإرسال في التذييل [#عناصر-الإرسال-في-التذييل]
| عنصر | التسمية |
| --------------- | ------------------------------------------------------------------------------------- |
| الزر الرئيسي | **Send N email(s)** (أو **Send emails** عندما يكون العدد 0) |
| قائمة الإرسال | **Send me a test email** |
| قائمة الإرسال | **Schedule send** |
| الترقية (مجاني) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| الترس | tooltip **Send pacing** |
| المساعدة | tooltip **Help** — يفتح قائمة التحقق داخل النافذة |
### قائمة Need help? [#قائمة-need-help]
1. اختر قالبًا وعمود مستلم
2. عاين كل صف بالأسهم
3. أرسل بريدًا تجريبيًا لنفسك أولًا
4. انقر Send للدمج من جدولك
الأزرار: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (إن وُجد) | **Close**
## ورقة فارغة [#ورقة-فارغة]
إذا لم يجد MailG عمود بريد صالح:
* العنوان: **No email address found in your sheet**
* الإجراءات: **Close** | **Fill with mock data**
Mock data يُنشئ رؤوس `Email`، `First Name`، `Last Name`، `Company` وقد يُنشئ **My First Template**.
## شاشات الأخطاء [#شاشات-الأخطاء]
| العنوان | متى |
| --------------------------------- | ---------------- |
| **Could not reach the MailG API** | فشل API / الشبكة |
| **Could not read your sheet** | فشل قراءة الجدول |
## التالي [#التالي]
# التثبيت (/ar/getting-started/installation)
خطوتان: تثبيت الإضافة، ثم تشغيلها من Sheets.
## تثبيت MailG [#تثبيت-mailg]
1. افتح [قائمة MailG على Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. انقر **Install**.
3. اختر حساب Google الذي يجب أن يملك التثبيت.
4. راجع الأذونات وانقر **Allow**.
عادةً ينتهي التثبيت في أقل من 15 ثانية. يجب أن ترى تأكيدًا بأن الإضافة ثُبّتت.
إذا لم تكن قائمة Marketplace متاحة بعد في منطقتك، استخدم زر التثبيت على [www.mailg.io](https://www.mailg.io) أو تواصل مع [contact@mailg.io](mailto:contact@mailg.io).
## تشغيل MailG في Google Sheets [#تشغيل-mailg-في-google-sheets]
1. افتح [Google Sheets](https://sheets.google.com) (حدّث إذا كان Sheets مفتوحًا بالفعل).
2. انتظر بضع ثوانٍ حتى تُحمّل Extensions (غالبًا \~10–15 ثانية).
3. انتقل إلى **Extensions → MailG for Gmail → 🚀 Start**.
لاحقًا يمكنك تشغيل **Extensions → MailG for Gmail → 🔄 Refresh Tracking** لمزامنة حالات الفتح دون فتح النافذة كاملة.
## مشاكل التثبيت [#مشاكل-التثبيت]
هذه خصائص شائعة في Google Workspace، وليست أخطاء في MailG:
### لا أرى نافذة «installed successfully» أبدًا [#لا-أرى-نافذة-installed-successfully-أبدًا]
يحدث هذا غالبًا عند تسجيل الدخول بعدة حسابات Google ولم يستخدم التثبيت الحساب المتوقع.
**الحل:** افتح نافذة خاصة/تصفح متخفي، سجّل الدخول بحساب الهدف فقط، ثم ثبّت مرة أخرى من Marketplace.
### MailG لا يظهر تحت Extensions [#mailg-لا-يظهر-تحت-extensions]
1. حدّث جدول البيانات.
2. انتظر نحو 10–15 ثانية حتى تُحمّل الإضافات.
3. تأكد أنك في نفس حساب Google الذي ثبّت MailG.
4. جرّب جدولًا آخر أو امسح ذاكرة التخزين المؤقت للمتصفح إذا كان لا يزال مفقودًا.
## النشر الذاتي / المخصص [#النشر-الذاتي--المخصص]
تثبيتات Marketplace مُعدّة مسبقًا. إذا نشرت MailG بنفسك، عيّن Apps Script script properties:
| Property | Value |
| ------------- | ---------------------------- |
| `APP_URL` | عنوان HTTPS عام لـ MailG API |
| `APP_API_KEY` | نفس المفتاح كما في خادم API |
لا يمكن للإضافة الوصول إلى `localhost` من خوادم Google — استخدم نفقًا (Cloudflare Tunnel، ngrok، إلخ) للاختبار المحلي.
## التالي [#التالي]
تابع مع [دليل دمج البريد](/getting-started/mail-merge-tutorial).
# دليل دمج البريد (/ar/getting-started/mail-merge-tutorial)
يتطابق هذا الدليل مع نافذة البدء **MailG for Gmail**.
## 1. افتح MailG [#1-افتح-mailg]
**Extensions → MailG for Gmail → 🚀 Start**.
إذا رأيت **No email address found in your sheet**، أضف عناوين بريد حقيقية أو انقر **Fill with mock data** (يُنشئ صفوفًا نموذجية وغالبًا **My First Template**). راجع [جولة في نافذة البدء](/getting-started/start-dialog).
## 2. أنشئ أو اختر قالبًا [#2-أنشئ-أو-اختر-قالبًا]
1. انقر **New Template** (أو اختر قالبًا موجودًا تحت **Template**).
2. عيّن **Template Name** و**Email Subject** (الموضوع **لا يُدمج** حاليًا).
3. اكتب النص وأدرج [merge tags](/features/merge-tags) عبر **Merge Tag**.
4. **Save Template**.
مثال على النص:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. إعداد الحملة [#3-إعداد-الحملة]
في الشريط الجانبي:
1. اختر **Recipient column** (يجب أن تحتوي الخلايا على بريد واحد صالح ليحسبها الواجهة).
2. افتح **More options** لـ **CC**، **BCC**، **Sender name**، **Reply to address**.
3. اترك **Track emails** مفعّلًا (افتراضي) إذا أردت حالة الفتح في الجدول.
4. على خطة مدفوعة، فعّل **Remove branding**.
يظهر **Attachments** تحت **More options**، لكن الملفات لا تُرفق عند الإرسال بعد. اربط Drive أو URL في النص بدلًا من ذلك.
## 4. المعاينة والاختبار [#4-المعاينة-والاختبار]
1. استخدم أسهم السابق/التالي للتنقل بين الصفوف.
2. تأكد من **To:** والنص المدمج (الموضوع يعرض موضوع القالب الخام).
3. قائمة الإرسال → **Send me a test email**.
4. تحقق من صندوق الوارد.
التفاصيل: [المعاينة والاختبار](/features/preview-and-test).
## 5. الإرسال أو الجدولة [#5-الإرسال-أو-الجدولة]
* الزر الرئيسي: **Send N email(s)** عند عد المستلمين.
* أو قائمة الإرسال → **Schedule send** → اختر التاريخ/الوقت → **Schedule Send**.
Busy overlays: `Starting your campaign…` / toasts تأكيد الجدولة.
يضيف MailG عمود حملة مثل `🚀 My Template (yyyy/MM/dd)` أو `🗓️ …` عند الجدولة.
حالات الصف:
| الحالة | المعنى |
| ------------- | ------------------- |
| 🗓️ Scheduled | في انتظار البدء |
| ⏳ Sending… | قيد المعالجة |
| ✉️ Sent | سُلّم إلى Gmail |
| ⚠️ Failed | خطأ |
| 👀 Opened | تم تحميل بكسل الفتح |
## أخطاء شائعة [#أخطاء-شائعة]
* وسوم الموضوع تتوقع تخصيصًا — النص فقط حاليًا
* خلايا مستلمين بعناوين متعددة مفصولة بفاصلة — الواجهة تتحقق من **بريد واحد** لكل خلية عند العد
* حساب Google خاطئ مقابل حساب التثبيت
* الوصول للحصة اليومية — تحقق من **Daily quota** في الشريط الجانبي
## نصائح [#نصائح]
* استخدم قائمة **Help** في التذييل في المرة الأولى
* ابدأ بـ 2–3 صفوف حقيقية بعد mock data
* بعد الفتح: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alert `Tracking info synced` (أو `No active campaigns`)
## التالي [#التالي]
# ما هو MailG؟ (/ar/getting-started/what-is-mailg)
يحوّل MailG جدول Google Sheets إلى حملة دمج بريد. كل صف هو مستلم؛ رؤوس الأعمدة تصبح merge tags (أقواس معقوفة مزدوجة حول اسم الرأس) في **email body**.
## ما يمكنك فعله [#ما-يمكنك-فعله]
* إنشاء قوالب مدعومة بالسحابة (**Template Name**، **Email Subject**، rich body)
* تخصيص **body** بـ merge tags من رؤوس الجدول
* معاينة الصفوف و**Send me a test email**
* ربط **CC** / **BCC**، **Sender name**، **Reply to address**
* **Schedule send** أو الإرسال فورًا
* **Track emails** مع رقائق حالة الفتح في الجدول
* التحكم في **Send pacing** على الخطط المدفوعة
* **Remove branding** على الخطط المدفوعة
* متابعة **Daily quota** (واختياريًا المطالبة بمكافأة مراجعة مجانية)
## كيف يتكامل كل شيء [#كيف-يتكامل-كل-شيء]
1. **إضافة Google Sheets** — نافذة تحت **MailG for Gmail**
2. **MailG API** — قوالب وبيانات الحملة وتتبع الفتح والصلاحيات
3. **Gmail الخاص بك** — رسائل تُرسل عبر `GmailApp` من الحساب المصرّح
## الخطوات التالية [#الخطوات-التالية]
# 联系我们 (/zh/contact-us)
## 账单与订阅 [#账单与订阅]
您可以通过 [pricing](https://app.mailg.io/pricing?lang=zh) 链接的 Stripe 门户管理大部分订阅变更。如需退款或遇到付款问题，请发邮件联系我们。
## 其他问题 [#其他问题]
请发送邮件至 **[contact@mailg.io](mailto:contact@mailg.io)**。
我们通常在一个工作日内回复。
## 实用链接 [#实用链接]
* [网站](https://www.mailg.io)
* [定价](https://app.mailg.io/pricing?lang=zh)
* [隐私政策](https://www.mailg.io/zh/privacy)
* [服务条款](https://www.mailg.io/zh/terms)
* [文档首页](/)
# MailG 文档 (/zh)
MailG 是一款用于 Gmail 邮件合并的 Google 表格插件。打开 **Extensions → MailG for Gmail → 🚀 Start**，创建模板、预览行，然后从您自己的 Gmail 账户发送或定时发送。
## 从这里开始 [#从这里开始]
## 热门主题 [#热门主题]
## 实用链接 [#实用链接]
* 网站: [www.mailg.io](https://www.mailg.io)
* 文档: [docs.mailg.io/zh](https://docs.mailg.io/zh)
* 定价: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=zh)
* 联系: [contact@mailg.io](mailto:contact@mailg.io)
## 面向 AI 助手 / 大模型 [#面向-ai-助手--大模型]
请优先使用这些机器可读端点，而不是抓取 HTML：
* [Agents hub](https://www.mailg.io/zh/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# 常见问题 (/zh/help/faq)
## 安装与打开 [#安装与打开]
**如何打开 MailG？**\
**Extensions → MailG for Gmail → 🚀 Start**。参见[安装](/getting-started/installation)。
**No email address found in your sheet**\
向列中添加邮箱，或点击 **Fill with mock data**。参见[启动对话框导览](/getting-started/start-dialog)。
**Could not reach the MailG API**\
检查网络 / API URL（自托管：`APP_URL` + `APP_API_KEY`）。修复后重新打开对话框。
## 发送 [#发送]
**邮件未发送**\
检查 **Daily quota**、Gmail 权限，以及 **Recipient column** 单元格是否为有效的单个邮箱。失败显示 **⚠️ Failed**。
**主题合并标签是否有效？**\
尚未支持。仅**正文**会合并。保持固定主题或将个性化放在正文中。参见[合并标签](/features/merge-tags)。
**可以附加文件吗？**\
**Attachments** 选择器存在于 **More options** 下，但发送时尚未附加文件。请使用链接。
**如何停止活动？**\
[停止活动](/features/stopping-a-campaign) — 清除剩余行的可发送状态。
**为何 Professional 仍有限制？**\
MailG 可能允许每天最多 1,500 封，但免费 `@gmail.com` 通常被 Google 限制在约 500 封。
## 跟踪 [#跟踪]
**打开后表格仍显示 Sent**\
**🔄 Refresh Tracking** → 预期 `Tracking info synced`。部分客户端从不加载图片。
**点击？**\
不跟踪。**Track emails** = 仅打开。
## 配额与账单 [#配额与账单]
参见[每日配额与评价](/help/daily-quota-and-reviews)和[账户与账单](/help/account-and-billing)。
**Schedule send 是否付费？**\
否。付费解锁更高配额、节奏模式和 **Remove branding**。
## 故障排除 [#故障排除]
逐步修复（API 错误、空表格、发送按钮禁用、失败行、跟踪、配额、定时未延后），参见[故障排除](/help/troubleshooting)。
您可能看到的常见 toast：
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## 仍无法解决？ [#仍无法解决]
[故障排除](/help/troubleshooting) · 文档 [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# 故障排除 (/zh/help/troubleshooting)
针对插件中看到的消息和状态的快速修复。
## 对话框无法加载 [#对话框无法加载]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
启动对话框无法调用 MailG 后端。
* 确认您已联网
* Marketplace 安装：稍等片刻后重新打开 **🚀 Start**
* 自托管：检查 Apps Script 属性 `APP_URL`（公开 HTTPS）和 `APP_API_KEY`
* 插件无法使用 `localhost` — 本地 API 测试请使用隧道
### Could not read your sheet [#could-not-read-your-sheet]
MailG 无法读取当前电子表格。
* 确保打开了表格标签页（不仅是 Apps Script 编辑器）
* 重新加载电子表格，然后重新打开对话框
* 确认您对该文件有编辑权限
### Loading… 永不结束 [#loading-永不结束]
关闭对话框，刷新表格，等待约 15 秒让 Extensions 加载，然后再次 **🚀 Start**。
## 空表格 [#空表格]
**No email address found in your sheet**
MailG 需要至少一列有效的邮箱地址。
* 在标题下添加邮箱，或点击 **Fill with mock data**
* 模拟数据创建 `Email`、`First Name`、`Last Name`、`Company`，并常创建 **My First Template**
参见[启动对话框导览](/getting-started/start-dialog)。
## 模板 [#模板]
* 创建：`Creating Template...` → `Template created successfully!` 或 `Failed to create template! Try again later.`
* 更新：`Updating template...`
* 删除失败：`Failed to delete template. Try again later`
参见[模板](/features/templates)。
## 发送问题 [#发送问题]
### 发送按钮禁用 / Send emails 无数 [#发送按钮禁用--send-emails-无数]
* 选择 **Template**
* 选择 **Recipient column**，每格为有效的**单个**邮箱
* 可能看到的拦截 toast：`Configure your recipient column first`、`Select a template first.`、`No valid recipient emails found in the selected column.`
### 活动无法启动 [#活动无法启动]
Toast: `Failed to create campaign. Please try again.`
* 重试一次
* 检查 **Daily quota** 不为 0
* 确认 API 连通性（见上文）
### 行显示 ⚠️ Failed [#行显示-️-failed]
该行遇到发送错误（无效地址、Gmail 拒绝、临时配额等）。修复数据并为剩余行启动新活动，或参见[停止活动](/features/stopping-a-campaign)。
### 测试邮件失败 [#测试邮件失败]
* `Configure your preview first` — 选择模板 + 收件人，使预览有 To
* `Failed to send test email. Please check your email settings.` — 如需要重新授权 Gmail，然后重试
## 跟踪 [#跟踪]
* 打开需要收件人加载远程图片
* 运行 **🔄 Refresh Tracking** — 预期 `Tracking info synced` 或 `No active campaigns`
* 状态 **👀 Opened** 仅在像素加载时出现
参见[邮件跟踪](/features/email-tracking)。
## 配额与品牌 [#配额与品牌]
* 侧边栏 **N left** 为 `min(MailG remaining, Gmail remaining)`
* 即使在 Professional 上，免费 `@gmail.com` 通常被 Google 限制在约 500/天
* 付费后仍有水印 → 结账邮箱须与表格账户一致；重新打开对话框
参见[每日配额与评价](/help/daily-quota-and-reviews)和[Remove branding](/features/remove-branding)。
## 定时未延后 [#定时未延后]
早于约 **15 秒**的时间被视为**立即**发送（🚀 列），而非延后的 🗓️ 定时。请选择更远的未来时间。
## 仍无法解决？ [#仍无法解决]
完整 FAQ：[常见问题](/help/faq) · 邮件 [contact@mailg.io](mailto:contact@mailg.io) · 网站 [app.mailg.io/help](https://www.mailg.io/zh/help)
# 每日配额与评价 (/zh/help/daily-quota-and-reviews)
根侧边栏在账户数据加载后显示您的发送容量。
## Daily quota 区块 [#daily-quota-区块]
精确 UI：
* Label: **Daily quota**
* Remaining: **N left**
* Plan line: **Your plan sends up to TOTAL/day**
**Remaining** 为以下两者的最小值：
1. MailG 方案当日剩余
2. 账户的 Gmail 剩余发送配额
因此即使 MailG 理论上仍有空间，您也可能被 Gmail 限制。另见[账户与账单](/help/account-and-billing)。
## 免费方案 CTA [#免费方案-cta]
未订阅时，侧边栏可能显示：
* **Leave a 5★ review for +N/day free**（API 未另行指定时，默认奖励为 **+50/day**）
* **Or upgrade your plan**
点击评价 CTA 打开 **Free Quota upgrade**：
* Title: **Free Quota upgrade**
* Body: leave a 5-star review to get a free quota upgrade of **+N emails/day**
* Buttons: **Not now** | **Leave a 5★ review**
若未配置评价 URL，**Leave a 5★ review** 保持禁用 — 请改用 **Upgrade to Pro** / pricing。
## 升级到 Pro [#升级到-pro]
页脚按钮（免费账户）：**Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
这与付费方案目前在产品中解锁的内容一致。
## 相关 [#相关]
* [Remove branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [常见问题](/help/faq)
# 账户与账单 (/zh/help/account-and-billing)
MailG 账单与表格中\*\* Google 账户的邮箱\*\*绑定。结账时务必使用同一地址，配额才能在插件中解锁。
## 方案与每日配额 [#方案与每日配额]
| 方案 | 每日配额 | 说明 |
| ------------ | ----- | --------------- |
| Free | 50 | 核心合并、打开跟踪、定时发送 |
| Personal | 250 | 适合增长中列表的热门方案 |
| Professional | 1,500 | 最高 recurring 配额 |
| Lifetime | 1,500 | 一次性购买 |
价格和周期见 [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=zh)（EUR 和 USD）。
付费权益还解锁：
* 非默认[发送节奏](/features/send-pacing)（**Steady pace** / **Jittered gaps**）
* [Remove branding](/features/remove-branding)
实际发送量为 `min(MailG daily quota, Gmail remaining quota)`。
## 如何升级 [#如何升级]
1. 打开 [pricing](https://app.mailg.io/pricing?lang=zh)（插件中也可通过 **Upgrade to Pro** 链接）。
2. 选择方案并使用表格 Google 邮箱完成 Stripe Checkout。
3. 在表格中重新打开 MailG，让账户刷新获取新限额。
## 取消或更新订阅 [#取消或更新订阅]
您可通过订阅/定价流程中链接的 Stripe 客户门户取消或更改订阅。
* 若在周期中途取消，Premium 功能保持有效至已付周期结束
* 取消生效后不会再次扣款
## 退款 [#退款]
若在购买后 **30 天内**取消 Premium 订阅，可发邮件至 [contact@mailg.io](mailto:contact@mailg.io) 申请全额退款。
## 发票 [#发票]
Stripe 会为成功付款发送收据。您也可从用于订阅管理的 Stripe 客户门户下载发票。
## 常见问题摘要 [#常见问题摘要]
**MailG 是否包含在 Google Workspace 中？**\
否。MailG 独立于 Google。Workspace 订阅不包含 MailG。
**接受哪些付款方式？**\
通过 Stripe 支持主流银行卡、Google Pay 和 Apple Pay。不支持 PayPal。
**已付款但仍看到免费限额 / 水印**\
几乎总是邮箱不匹配。确认结账邮箱 = 表格账户邮箱，然后重新打开插件。若仍如此，请联系支持并提供两个邮箱。
**为何免费 Gmail 每天约限 500 封？**\
MailG Professional 允许每天最多 1,500 封，但 Google 本身将免费 `@gmail.com` 账户限制在每天约 500 封。Google Workspace 账户可更高。这是 Gmail 提供商限制，非 MailG 限制。
# 活动定时发送 (/zh/features/campaign-scheduling)
当您希望 MailG 稍后开始时，使用 **Schedule send**。免费版和付费版均可用。
## 如何定时发送 [#如何定时发送]
1. 配置模板和收件人，使发送按钮可用。
2. 打开发送菜单（chevron）→ **Schedule send**。
3. 对话框标题：**Schedule send**
4. 描述：`Pick date & time to schedule sending`
5. 摘要行：scheduling N emails to be sent starting at the chosen date/time
6. 使用日期选择器以及 **Hour** / **Minute**（占位符 `Hour`、`Min`）。
7. 用 **Schedule Send** 确认（或 **Cancel**）。
默认建议约为**提前 60 分钟**，对齐到下一个 **15 分钟**步长。
## 立即发送与定时发送 [#立即发送与定时发送]
早于约 **15 秒**的时间被视为**立即**发送（🚀 列标题），而非延后的 🗓️ 定时。若需延后发送，请选择更远的未来时间。
验证 toast：`Please select a date and time`、`Invalid date and time`、`Pick a date and time in the future`。
成功 toast：campaign scheduled; N emails will start at the chosen time.
## 表格列 [#表格列]
定时活动会创建如下列标题：
```text
🗓️ Template name (yyyy/MM/dd)
```
立即发送使用 🚀 而非 🗓️。
行初始为 **🗓️ Scheduled**，队列运行后变为 **⏳ Sending…**。
## 定时发送之后 [#定时发送之后]
* 保持电子表格对拥有插件的 Google 账户可访问
* 开始发送后，跟踪和节奏设置仍然适用
* 无 **Manage Schedule** 界面 — 参见[停止活动](/features/stopping-a-campaign)
## 相关 [#相关]
* [预览与测试](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# 多个收件人 (/zh/features/multiple-recipients)
您可以使用专用表格列为每行添加抄送收件人。
## 收件人列（To） [#收件人列to]
在侧边栏选择 **Recipient column**。
对于发送按钮计数和列验证，MailG 将单元格视为有效当且仅当它是**单个**邮箱地址。建议每行一个主要 To 地址。
## CC 和 BCC 列 [#cc-和-bcc-列]
1. 在表格中添加列（例如 `CC` 和 `BCC`）。
2. 在单元格中填入邮箱（或 Gmail 接受的列表）。
3. 打开 **More options** 并映射 **CC** / **BCC**。
4. 发送时，这些值会传递给 Gmail。
预览窗格仅显示 **From**、**To**、**Subject** 和正文。即使已映射，也**不会**显示 CC/BCC 行。若需验证 CC/BCC 投递，请用 **Send me a test email** 确认。
## 配额：MailG 与 Gmail [#配额mailg-与-gmail]
* **MailG 每日配额**统计已处理的**活动行数**。
* **Gmail 发送限制**统计**收件人**（Gmail 在该次发送中接受的 To + CC + BCC 地址）。
MailG 配额仍有剩余时，您仍可能触及 Gmail 上限。
## 提示 [#提示]
* 收件人不应互相可见时，优先使用 **BCC**
* 未使用时不要映射 CC/BCC
* 大量发送前验证地址
# Attachments (/zh/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# 功能概览 (/zh/features/features-overview)
插件目前支持的内容：
| 功能 | 文档 |
| ---------------------- | -------------------------------------------- |
| 启动对话框 / 空表格 / 模拟数据 | [启动对话框导览](/getting-started/start-dialog) |
| 模板（创建 / 管理 / 编辑 / 删除） | [模板](/features/templates) |
| **正文**中的合并标签 | [合并标签](/features/merge-tags) |
| 富文本工具栏 | [富文本邮件](/features/rich-text-emails) |
| 链接（非图片嵌入） | [图片](/features/images) |
| 预览 + 测试邮件 | [预览与测试](/features/preview-and-test) |
| Schedule send | [活动定时发送](/features/campaign-scheduling) |
| Send pacing（付费） | [Send pacing](/features/send-pacing) |
| CC / BCC 列 | [多个收件人](/features/multiple-recipients) |
| Track emails | [邮件跟踪](/features/email-tracking) |
| Sender name 与 reply-to | [自定义发件人](/features/customized-sender) |
| Remove branding（付费） | [Remove branding](/features/remove-branding) |
| 停止剩余行 | [停止活动](/features/stopping-a-campaign) |
| 每日配额 + 评价奖励 | [每日配额与评价](/help/daily-quota-and-reviews) |
## 免费版与付费版 [#免费版与付费版]
付费版解锁：
* 非默认[发送节奏](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* 更高的[每日配额](/help/account-and-billing)
**Schedule send**、**Track emails** 和模板工具无需付费升级即可使用。
## 已知限制（如实说明） [#已知限制如实说明]
| 主题 | 产品现状 |
| ----------------------- | -------------- |
| 主题合并标签 | 发送时不应用 — 仅正文 |
| Attachments 列 | 仅 UI — 发送时不附加 |
| 图片嵌入 | 无编辑器控件 — 请使用链接 |
| 预览 CC/BCC 行 | 预览 UI 中不显示 |
| Manage Schedule / Pause | 尚未发布 — 状态变通方法 |
## 即将推出 [#即将推出]
取消订阅链接、点击跟踪、团队共享席位，以及专用的活动管理界面，上线后将在此更新。
# 邮件跟踪 (/zh/features/email-tracking)
MailG 可通过微小的不可见像素记录打开情况。
## 启用跟踪 [#启用跟踪]
在侧边栏保持 **Track emails** 开启（新任务的默认值为开启）。
Tooltip: `Track emails opened with a tiny pixel`
帮助图标打开 **Email tracking**：
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
按钮：**Got it**
## 表格状态 [#表格状态]
| 状态 | 含义 |
| ------------- | ------------ |
| 🗓️ Scheduled | 等待定时开始 |
| ⏳ Sending… | 正在处理 |
| ✉️ Sent | 该行已投递至 Gmail |
| ⚠️ Failed | 该行发送错误 |
| 👀 Opened | 打开像素已加载 |
活动列标题形如 `🚀 Template name (yyyy/MM/dd)` 或定时时的 `🗓️ …`。
## 刷新跟踪 [#刷新跟踪]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Apps Script 提示：
* `Tracking info synced`
* `No active campaigns`
## 限制 [#限制]
* 客户端须加载远程图片
* 隐私代理可能隐藏打开记录
* 仅打开 — 不跟踪链接点击
## 相关 [#相关]
* [活动定时发送](/features/campaign-scheduling)
* [常见问题](/help/faq)
# 合并标签 (/zh/features/merge-tags)
合并标签让每位收件人获得个性化的**正文**。标签是**精确的列标题**，用双花括号包裹。
## 语法 [#语法]
若表格有名为 `First Name` 的列，请使用：
```text
{{First Name}}
```
正文示例：
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## 合并标签目前适用的字段 [#合并标签目前适用的字段]
| 字段 | 发送时合并？ |
| --------------- | ------------------- |
| Email body | **是** — 按行注入变量 |
| Email subject | **否** — 主题按模板存储内容发送 |
| Preview body | **是** — 当前活动行 |
| Preview subject | **否** — 显示原始模板主题 |
在主题合并功能上线前，请将个性化内容放在正文中。
## 插入标签 [#插入标签]
在编辑器工具栏中打开 **Merge Tag**。它会列出当前表格的标题。空状态：`No sheet columns found`。
插入的文本使用双花括号包裹列名。
## 实用规则 [#实用规则]
* 标题区分大小写（`Name` ≠ `name`）
* 空单元格插入为空字符串
* 正文中可多次使用同一标签
* 收件人 / CC / BCC 在 **More options** 下选择，不能通过合并标签设置
## 下一步 [#下一步]
参见[富文本邮件](/features/rich-text-emails)和[预览与测试](/features/preview-and-test)。
# 富文本邮件 (/zh/features/rich-text-emails)
MailG 模板使用 TipTap 富文本编辑器。它生成的 HTML 即为 Gmail 发送的内容。
正文占位符：`Write your email…`
## 工具栏清单（精确 UI） [#工具栏清单精确-ui]
| 分组 | 控件 |
| ----- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| 字体 | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| 字号 | **10pt** … **24pt**（工具栏预设） |
| 标记 | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| 颜色 | 预设色块 + 原生颜色选择器 + **Reset** |
| 对齐 | **Align left**, **Align center**, **Align right**, **Justify** |
| 列表 | **Bullet list**, **Numbered list** |
| 链接 | **Insert link** — URL 字段占位符 `https://example.com`，然后 **Apply**（及取消链接） |
| 历史 | **Undo**, **Redo** |
## 编辑器中不可用 [#编辑器中不可用]
以下 TipTap 功能已禁用 / 不存在：
* Headings, code, code block, blockquote, horizontal rule
* Image insert / Drive media picker — see [Images](/features/images)
## 超链接 [#超链接]
使用 **Insert link** 设置 URL 和可见文本。优先使用清晰的链接文字，而非原始 URL。
## 提示 [#提示]
* 使用 **Merge Tag**，不要手动输入花括号
* 发送前预览多行 — 参见[预览与测试](/features/preview-and-test)
* 避免粘贴大量 Word/Docs 标记；在 MailG 中重新应用格式以获得更干净的 HTML
# 移除 MailG 品牌 (/zh/features/remove-branding)
免费活动可能在邮件页脚包含小型 MailG 水印。付费订阅者可将其关闭。
## 如何移除品牌 [#如何移除品牌]
1. 确认您有有效的付费方案（Personal、Professional 或 Lifetime）。
2. 打开活动侧边栏。
3. 启用 **Remove branding**。
4. 预览一行以确认水印已消失，然后发送。
若付费后仍显示品牌：
* 确保结账使用的**邮箱**与 Google 表格账户一致
* 重新打开插件，从 API 刷新权益
* 联系 [contact@mailg.io](mailto:contact@mailg.io) 并提供您的 Google 账户邮箱
参见[账户与账单](/help/account-and-billing)。
# 图片 (/zh/features/images)
MailG 编辑器**没有图片插入按钮**，也没有 Google Drive 媒体选择器。TipTap 的 Image 扩展未启用。
## 目前可用的方式 [#目前可用的方式]
使用工具栏中的 **Insert link**：
1. 将图片（或文件）托管在公开 URL，或分享 Drive 链接。
2. 选中文本（或放置光标）→ **Insert link**。
3. 粘贴 URL（占位符 `https://example.com`）→ **Apply**。
收件人打开链接查看图片或文件。编辑器不会为您嵌入 `![]()
` 标签。
## 提示 [#提示]
* 优先使用小文件和清晰的链接文字（“View screenshot”）
* 需要登录的链接对收件人无效
* 用 **Send me a test email** 确认
## 即将推出 [#即将推出]
一流的图片嵌入 / Drive 选择器可能稍后上线。在此之前，超链接是支持的方式。
# 模板 (/zh/features/templates)
模板存储您在活动中重复使用的主题和富文本正文。它们会保存到 MailG API，与您的 Google 账户关联。
## 创建模板 [#创建模板]
1. 在根界面点击 **New Template**。
2. 填写：
* **Template Name**
* **Email Subject**
* 正文（富文本编辑器 — 参见[富文本邮件](/features/rich-text-emails)）
3. 点击 **Save Template**（处理中显示 **Saving...**）。
Toasts：
* Loading: `Creating Template...`
* Success: `Template created successfully!`
* Error: `Failed to create template! Try again later.`
**Fill with mock data** 的演示模板：名称 **My First Template**，主题 `I found a mail merge tool for Gmail`。
## 管理模板 [#管理模板]
打开模板选择旁的模板图标（tooltip **Manage templates**）。
表格列：
| 列 | 内容 |
| ----------------- | ---- |
| **Name** | 模板名称 |
| **Email Subject** | 主题行 |
| **Created At** | 创建日期 |
| **Actions** | 行菜单 |
行菜单：**Edit** | **Delete**
页脚：**Back**
删除 toast：deleting template NAME → template NAME deleted successfully（或失败消息）。
## 编辑模板 [#编辑模板]
从管理界面打开 **Edit**，或点击预览工具栏中的 **Edit template**。
字段与创建相同。**Save Template** 会更新模板。
更新流程会显示加载 toast（`Updating template...`）。请留在表单直到完成，若未自动返回，请使用 **Cancel** 或 **Back**。
## 主题与正文 [#主题与正文]
* **Body** 支持[合并标签](/features/merge-tags) — 发送时按行注入。
* **Email Subject** 目前按存储内容发送（主题中的合并标签**尚未**替换）。将个性化内容放在正文中，或使用固定主题。
## 相关 [#相关]
* [预览与测试](/features/preview-and-test)
* [启动对话框导览](/getting-started/start-dialog)
# 预览与测试 (/zh/features/preview-and-test)
预览窗格（根对话框右侧）显示当前表格行的邮件效果。
## 预览显示的内容 [#预览显示的内容]
| 字段 | 内容 |
| ------------ | --------------------------------------------------------- |
| **From:** | 您登录的 Google 账户邮箱 |
| **To:** | 当前行 **Recipient column** 的值，或 `Select a recipient column` |
| **Subject:** | 按存储的模板主题（不进行合并替换） |
| Body | 对该行应用合并标签的模板正文 |
若 **Remove branding** 未开启，预览包含 MailG 水印页脚（`made and sent with` / **MailG** / `Email Marketing from Gmail`）。
## 不显示的内容 [#不显示的内容]
* **CC** / **BCC** 行不在预览界面中渲染（即使在 **More options** 下已映射）。发送时仍会应用。
* 预览中不显示附件列的值。
## 浏览行 [#浏览行]
预览工具栏：
* **Edit template** — 打开更新模板界面
* **Previous recipient** / **Next recipient** — 在数据行间移动（tooltip 可能包含表格行号；标题为第 1 行，因此第一个联系人为第 2 行）
## 给我发送测试邮件 [#给我发送测试邮件]
1. 配置模板 + 收件人列，使预览有效。
2. 打开发送菜单（chevron）→ **Send me a test email**。
3. 忙碌遮罩：`Sending test email…`
4. 成功 toast：`Test email sent successfully. Check your inbox.`
5. 失败 toast：`Failed to send test email. Please check your email settings.`
6. 预览不完整时的拦截：`Configure your preview first`
测试邮件发送到**您的** Google 账户收件箱，使用当前预览行的合并正文。
## 提示 [#提示]
* 全量发送前用箭头浏览多行
* 在预览中确认有水印/无水印
* 在 **Schedule send** 或大量 **Send N email(s)** 之前务必测试
## 相关 [#相关]
* [合并标签](/features/merge-tags)
* [邮件合并教程](/getting-started/mail-merge-tutorial)
# 发送节奏 (/zh/features/send-pacing)
Send pacing 在邮件之间添加延迟，避免大型活动一次性从您的账户发出。
**Steady pace** 和 **Jittered gaps** 需要有效的 MailG 付费订阅。免费账户仅可使用 **Burst send**。
## 配置位置 [#配置位置]
打开页脚齿轮（tooltip **Send pacing**）。界面标题：**Send pacing**。
在 **Dispatch mode** 下选择邮件间隔方式。**Gap between emails** 以**秒**为单位（0–60）。免费账户会看到 **Pro features** 及锁定文案：`Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
新任务默认：**Burst send**，间隔 **10s**（离开 burst 模式前间隔被忽略）。
## 模式 [#模式]
| 模式（UI 标签） | 行为 |
| ------------------ | ------------------ |
| **Burst send**（默认） | 在配额允许范围内尽快发送 |
| **Steady pace** | 每封邮件之间等待固定间隔 |
| **Jittered gaps** | 在 0 与您选择的最大值之间随机等待 |
## 为何使用节奏控制 [#为何使用节奏控制]
* 降低被邮箱服务商视为突发群发的风险
* 将长列表分散到更安静的发送窗口
* 保持在 Gmail 对您账户类型的舒适发送范围内
## 说明 [#说明]
* 节奏是随任务存储的活动设置 — 新发送使用当前配置
* 长列表上的大间隔会显著增加活动总时长
* 实际速度仍受 MailG 每日配额**和** Gmail 剩余发送配额限制
* 竞品有时以分钟表示延迟 — MailG 使用**秒**
## 相关 [#相关]
* 若运行中间隔设置过高，参见[停止活动](/features/stopping-a-campaign)
* [账户与账单](/help/account-and-billing)
# 停止活动 (/zh/features/stopping-a-campaign)
MailG 尚未提供专用的 **Manage Schedule**、**Abort** 或 **Pause** 界面（与部分竞品不同）。您仍可阻止**剩余**行发送。
## 发送循环如何处理行 [#发送循环如何处理行]
发送循环仅处理活动列状态仍可发送的行：
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
已标记为 **✉️ Sent**、**⚠️ Failed** 或 **👀 Opened** 的行会被跳过。
## 停止剩余行（实用变通方法） [#停止剩余行实用变通方法]
对大型活动请尽快操作：
1. 打开电子表格。
2. 在活动状态列中，清除或更改**不应**发送的行的状态（例如删除单元格值，或设置为不可发送的标签如 `Stopped`）。
3. 已 **✉️ Sent** 的行不要动 — 这些邮件已发出。
您清除/更改的行不再匹配可发送状态，队列在下一轮会跳过它们。
已离开账户的 Gmail 邮件无法由 MailG 撤回。停止操作仅保护尚未处理的行。
## 尚未开始的定时活动 [#尚未开始的定时活动]
若每行仍为 **🗓️ Scheduled** 且开始时间未到，清除这些状态（或活动列）可防止时间到达时队列拾取它们。
若不确定，请联系 [contact@mailg.io](mailto:contact@mailg.io)，并提供电子表格 URL 和活动详情。
## 相关 [#相关]
* [活动定时发送](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [常见问题](/help/faq)
# 自定义发件人 (/zh/features/customized-sender)
默认情况下，Gmail 从授权 MailG 的 Google 账户发送。您仍可自定义显示名称和回复地址。
## 发件人姓名 [#发件人姓名]
1. 在活动侧边栏打开 **More options**。
2. 设置 **Sender name**（占位符 `John Doe (Optional)`）。
3. 收件人在收件箱中看到该显示名称（受 Gmail 常规展示规则约束）。
## 回复地址 [#回复地址]
若回复应发往发送账户以外的地址，设置 **Reply to address**（占位符 `john@doe.com (Optional)`）。
## 说明 [#说明]
* 底层 From 地址仍是授权的 Gmail 账户 — 无法伪造其他邮箱
* 无效的 reply-to 地址可能导致投递或回复问题 — 请使用您控制的邮箱
* 预览中 **From:** 显示您登录的邮箱；用 **Send me a test email** 确认 reply-to
* 参见[预览与测试](/features/preview-and-test)
# 启动对话框导览 (/zh/getting-started/start-dialog)
通过 **Extensions → MailG for Gmail → 🚀 Start** 打开插件。会打开一个 900×600 的对话框，标题为 **MailG for Gmail**。
## 界面 [#界面]
| 界面 | 进入方式 | 用途 |
| ---------------- | ---------------------------------- | ------------------- |
| Root（编辑器） | 加载后默认 | 选择模板 + 收件人、预览、发送 |
| Create template | **New Template** | 名称、主题、正文 |
| Manage templates | 模板图标（tooltip **Manage templates**） | 列表、编辑、删除 |
| Update template | **Edit template** 或行 **Edit** | 编辑已有模板 |
| Settings | 页脚齿轮（tooltip **Send pacing**） | Dispatch mode + gap |
| Empty sheet | 无有效邮箱列 | 提示添加联系人或模拟数据 |
| API / 表格错误 | 加载失败 | 重试指引 |
## 根布局 [#根布局]
三个区域：
1. **Sidebar**（左侧）— 模板、收件人列、**More options**、跟踪、品牌、配额
2. **Preview**（右侧）— From / To / Subject / 正文、行导航、**Edit template**
3. **Footer** — 发送按钮、发送菜单、**Upgrade to Pro**（免费版）、设置、帮助
## 侧边栏控件（精确标签） [#侧边栏控件精确标签]
* **New Template**
* **Template**（选择）— 占位符 `Select` 或 `No templates found`
* **Recipient column** — 选项如 `A - Email`；为空时：`No valid email columns found.`
* **More options** — 展开 **Attachments**、**CC**、**BCC**、**Sender name**、**Reply to address**
* **Track emails**（默认开启）
* **Remove branding**（付费）
* **Daily quota** — 剩余数量显示为 “N left”，方案行 “Your plan sends up to TOTAL/day”
免费账户还会看到 **Leave a 5★ review for +N/day free** 和 **Or upgrade your plan**。参见[每日配额与评价](/help/daily-quota-and-reviews)。
## 页脚发送控件 [#页脚发送控件]
| 控件 | 标签 |
| ------ | ------------------------------------------------------------------------------------- |
| 主按钮 | **Send N email(s)**（计数为 0 时为 **Send emails**） |
| 发送菜单 | **Send me a test email** |
| 发送菜单 | **Schedule send** |
| 升级（免费） | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| 齿轮 | tooltip **Send pacing** |
| 帮助 | tooltip **Help** — 打开对话框内清单 |
### Need help? 清单 [#need-help-清单]
1. 选择模板和收件人列
2. 用箭头预览每一行
3. 先向自己发送测试邮件
4. 点击 Send 从表格合并发送
按钮：**Open docs**（[docs.mailg.io](https://docs.mailg.io)）| **View pricing**（若可用）| **Close**
## 空表格 [#空表格]
若 MailG 未找到有效的邮箱列：
* 标题：**No email address found in your sheet**
* 操作：**Close** | **Fill with mock data**
模拟数据会填充标题 `Email`、`First Name`、`Last Name`、`Company`，并可能创建 **My First Template**。
## 错误界面 [#错误界面]
| 标题 | 何时出现 |
| --------------------------------- | ---------- |
| **Could not reach the MailG API** | API / 网络故障 |
| **Could not read your sheet** | 表格读取失败 |
## 下一步 [#下一步]
# 安装 (/zh/getting-started/installation)
两步完成：安装插件，然后从表格中启动。
## 安装 MailG [#安装-mailg]
1. 打开 [Google Workspace Marketplace 上的 MailG 页面](https://workspace.google.com/marketplace/app/mailg)。
2. 点击 **Install**。
3. 选择应拥有此安装的 Google 账户。
4. 查看权限并点击 **Allow**。
安装通常在 15 秒内完成。您应看到插件已成功安装的确认信息。
如果您所在地区尚未上线 Marketplace 列表，请使用 [www.mailg.io](https://www.mailg.io) 上的安装按钮，或联系 [contact@mailg.io](mailto:contact@mailg.io)。
## 在 Google 表格中启动 MailG [#在-google-表格中启动-mailg]
1. 打开 [Google 表格](https://sheets.google.com)（若表格已打开，请先刷新）。
2. 等待几秒让扩展程序加载（通常约 10–15 秒）。
3. 前往 **Extensions → MailG for Gmail → 🚀 Start**。
之后您可以运行 **Extensions → MailG for Gmail → 🔄 Refresh Tracking**，在不打开完整对话框的情况下同步打开状态。
## 安装问题 [#安装问题]
这些通常是 Google Workspace 的常见问题，并非 MailG 的缺陷：
### 从未看到“安装成功”弹窗 [#从未看到安装成功弹窗]
这通常发生在登录了多个 Google 账户，且安装未使用您预期的账户时。
**解决方法：** 打开无痕/隐私窗口，仅登录目标账户，然后从 Marketplace 重新安装。
### Extensions 下看不到 MailG [#extensions-下看不到-mailg]
1. 刷新电子表格。
2. 等待约 10–15 秒让插件加载。
3. 确认您使用的是安装 MailG 的同一 Google 账户。
4. 若仍缺失，请尝试另一张表格或清除浏览器缓存。
## 自托管 / 自定义部署 [#自托管--自定义部署]
Marketplace 安装已预配置。若自行部署 MailG，请设置 Apps Script 脚本属性：
| Property | Value |
| ------------- | ----------------------- |
| `APP_URL` | MailG API 的公开 HTTPS URL |
| `APP_API_KEY` | 与 API 服务器相同的密钥 |
插件无法从 Google 服务器访问 `localhost` — 本地测试请使用隧道（Cloudflare Tunnel、ngrok 等）。
## 下一步 [#下一步]
继续阅读[邮件合并教程](/getting-started/mail-merge-tutorial)。
# 邮件合并教程 (/zh/getting-started/mail-merge-tutorial)
本教程与 **MailG for Gmail** 启动对话框一致。
## 1. 打开 MailG [#1-打开-mailg]
**Extensions → MailG for Gmail → 🚀 Start**。
若看到 **No email address found in your sheet**，请添加真实邮箱或点击 **Fill with mock data**（创建示例行，并常创建 **My First Template**）。参见[启动对话框导览](/getting-started/start-dialog)。
## 2. 创建或选择模板 [#2-创建或选择模板]
1. 点击 **New Template**（或在 **Template** 下选择已有模板）。
2. 设置 **Template Name** 和 **Email Subject**（主题目前**不会**进行合并替换）。
3. 编写正文，通过 **Merge Tag** 插入[合并标签](/features/merge-tags)。
4. **Save Template**。
正文示例：
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. 配置活动 [#3-配置活动]
在侧边栏中：
1. 选择 **Recipient column**（单元格必须是有效的单个邮箱，界面才会计数）。
2. 打开 **More options** 设置 **CC**、**BCC**、**Sender name**、**Reply to address**。
3. 若要在表格中显示打开状态，保持 **Track emails** 开启（默认）。
4. 在付费方案上，启用 **Remove branding**。
**Attachments** 出现在 **More options** 下，但发送时尚未附加文件。请在正文中链接到 Drive 或 URL。
## 4. 预览与测试 [#4-预览与测试]
1. 使用上一条/下一条箭头浏览各行。
2. 确认 **To:** 和合并后的正文（主题显示原始模板主题）。
3. 发送菜单 → **Send me a test email**。
4. 检查收件箱。
详情：[预览与测试](/features/preview-and-test)。
## 5. 发送或定时发送 [#5-发送或定时发送]
* 主按钮：有收件人计数时显示 **Send N email(s)**。
* 或发送菜单 → **Schedule send** → 选择日期/时间 → **Schedule Send**。
忙碌遮罩：`Starting your campaign…` / 定时确认 toast。
MailG 会添加活动列，如 `🚀 My Template (yyyy/MM/dd)` 或定时时的 `🗓️ …`。
行状态：
| 状态 | 含义 |
| ------------- | --------- |
| 🗓️ Scheduled | 等待开始 |
| ⏳ Sending… | 处理中 |
| ✉️ Sent | 已交给 Gmail |
| ⚠️ Failed | 错误 |
| 👀 Opened | 打开像素已加载 |
## 常见错误 [#常见错误]
* 主题标签期望个性化 — 目前仅正文支持
* 收件人单元格含多个逗号分隔地址 — 界面验证每格**一个**邮箱用于计数
* Google 账户与安装账户不一致
* 达到每日配额 — 查看侧边栏 **Daily quota**
## 提示 [#提示]
* 首次使用页脚 **Help** 清单
* 模拟数据后先用 2–3 行真实数据
* 打开跟踪后：**Extensions → MailG for Gmail → 🔄 Refresh Tracking** → 提示 `Tracking info synced`（或 `No active campaigns`）
## 下一步 [#下一步]
# 什么是 MailG？ (/zh/getting-started/what-is-mailg)
MailG 将 Google 表格变成邮件合并活动。每一行是一位收件人；列标题在**邮件正文**中成为合并标签（用双花括号包裹标题名称）。
## 您可以做什么 [#您可以做什么]
* 创建云端模板（**Template Name**、**Email Subject**、富文本正文）
* 使用表格标题中的合并标签个性化**正文**
* 预览行并 **Send me a test email**
* 映射 **CC** / **BCC**、**Sender name**、**Reply to address**
* **Schedule send** 或立即发送
* 使用表格中的打开状态标记 **Track emails**
* 在付费方案上控制 **Send pacing**
* 在付费方案上 **Remove branding**
* 查看 **Daily quota**（并可选择领取免费评价奖励）
## 整体架构 [#整体架构]
1. **Google 表格插件** — **MailG for Gmail** 下的对话框
2. **MailG API** — 模板、活动元数据、打开跟踪、权益
3. **您的 Gmail** — 通过授权账户使用 `GmailApp` 发送邮件
## 下一步 [#下一步]
# 문의하기 (/ko/contact-us)
## 결제 및 구독 [#결제-및-구독]
대부분의 구독 변경은 [요금](https://app.mailg.io/pricing?lang=ko) 페이지에 연결된 Stripe 포털에서 관리할 수 있습니다. 환불이나 결제 문제는 이메일로 문의해 주세요.
## 그 외 문의 [#그-외-문의]
**[contact@mailg.io](mailto:contact@mailg.io)** 로 이메일을 보내 주세요.
보통 영업일 기준 1일 이내에 답변드립니다.
## 유용한 링크 [#유용한-링크]
* [웹사이트](https://www.mailg.io)
* [요금](https://app.mailg.io/pricing?lang=ko)
* [개인정보 처리방침](https://www.mailg.io/ko/privacy)
* [이용약관](https://www.mailg.io/ko/terms)
* [문서 홈](/)
# MailG 문서 (/ko)
MailG는 Gmail 메일 병합을 위한 Google Sheets 부가 기능입니다. **Extensions → MailG for Gmail → 🚀 Start**를 열고, 템플릿을 만든 뒤 행을 미리 보면, 본인 Gmail 계정에서 바로 보내거나 예약할 수 있습니다.
## 여기서 시작 [#여기서-시작]
## 인기 주제 [#인기-주제]
## 유용한 링크 [#유용한-링크]
* 웹사이트: [www.mailg.io](https://www.mailg.io)
* 문서: [docs.mailg.io/ko](https://docs.mailg.io/ko)
* 요금: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=ko)
* 문의: [contact@mailg.io](mailto:contact@mailg.io)
## AI 어시스턴트 / LLM용 [#ai-어시스턴트--llm용]
HTML을 스크랩하기보다 다음 기계 가독 엔드포인트를 사용하세요:
* [Agents hub](https://www.mailg.io/ko/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/ko/help/faq)
## 설치 및 실행 [#설치-및-실행]
**MailG는 어떻게 여나요?**\
**Extensions → MailG for Gmail → 🚀 Start**. [설치](/getting-started/installation) 참고.
**No email address found in your sheet**\
열에 이메일을 추가하거나 **Fill with mock data** 클릭. [시작 대화상자 둘러보기](/getting-started/start-dialog) 참고.
**Could not reach the MailG API**\
네트워크 / API URL 확인(셀프 호스팅: `APP_URL` + `APP_API_KEY`). 수정 후 대화상자 다시 열기.
## 발송 [#발송]
**이메일이 발송되지 않음**\
**Daily quota**, Gmail 권한, **Recipient column** 셀이 유효한 단일 이메일인지 확인. 실패는 **⚠️ Failed** 표시.
**제목 병합 태그가 동작하나요?**\
아직 아닙니다. **본문**만 병합됩니다. 고정 제목을 쓰거나 개인화는 본문에 넣으세요. [병합 태그](/features/merge-tags) 참고.
**파일을 첨부할 수 있나요?**\
**More options** 아래 **Attachments** 선택기는 있지만, 아직 발송 시 첨부되지 않습니다. 링크를 사용하세요.
**캠페인을 어떻게 중지하나요?**\
[캠페인 중지](/features/stopping-a-campaign) — 남은 행의 발송 가능 상태 지우기.
**Professional인데 왜 제한되나요?**\
MailG는 하루 1,500통까지 허용할 수 있지만, 무료 `@gmail.com`은 Google이 보통 약 500통 근처로 제한합니다.
## 추적 [#추적]
**열었는데 시트에 Sent로 남음**\
**🔄 Refresh Tracking** → `Tracking info synced` 예상. 일부 클라이언트는 이미지를 로드하지 않습니다.
**클릭 추적?**\
추적 안 됨. **Track emails** = 열림만.
## 할당량 및 결제 [#할당량-및-결제]
[일일 할당량 및 리뷰](/help/daily-quota-and-reviews) 및 [계정 및 결제](/help/account-and-billing) 참고.
**Schedule send는 유료인가요?**\
아니요. 유료는 더 높은 할당량, pacing 모드, **Remove branding**을 잠금 해제합니다.
## 문제 해결 [#문제-해결]
단계별 수정(API 오류, 빈 시트, 발송 버튼 비활성, 실패 행, 추적, 할당량, 예약 미지연)은 [문제 해결](/help/troubleshooting) 참고.
볼 수 있는 토스트:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## 여전히 막히나요? [#여전히-막히나요]
[문제 해결](/help/troubleshooting) · 문서 [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# 문제 해결 (/ko/help/troubleshooting)
부가 기능에서 보는 메시지와 상태에 대한 빠른 수정 방법입니다.
## 대화상자가 로드되지 않음 [#대화상자가-로드되지-않음]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
시작 대화상자가 MailG 백엔드를 호출하지 못했습니다.
* 온라인 상태 확인
* Marketplace 설치: 잠시 기다린 뒤 **🚀 Start** 다시 열기
* 셀프 호스팅: Apps Script 속성 `APP_URL`(공개 HTTPS) 및 `APP_API_KEY` 확인
* 부가 기능은 `localhost` 사용 불가 — 로컬 API 테스트에는 터널 사용
### Could not read your sheet [#could-not-read-your-sheet]
MailG가 활성 스프레드시트를 읽지 못했습니다.
* 시트 탭이 열려 있는지 확인(Apps Script 편집기만 열려 있으면 안 됨)
* 스프레드시트 새로고침 후 대화상자 다시 열기
* 파일 편집 권한 확인
### Loading…이 끝나지 않음 [#loading이-끝나지-않음]
대화상자 닫기, Sheets 새로고침, Extensions 로드를 약 15초 기다린 뒤 **🚀 Start** 다시 실행.
## 빈 시트 [#빈-시트]
**No email address found in your sheet**
MailG는 유효한 이메일 주소가 있는 열이 최소 하나 필요합니다.
* 헤더 아래에 이메일 추가, 또는 **Fill with mock data** 클릭
* Mock data는 `Email`, `First Name`, `Last Name`, `Company`를 만들고 종종 **My First Template** 생성
[시작 대화상자 둘러보기](/getting-started/start-dialog) 참고.
## 템플릿 [#템플릿]
* 만들기: `Creating Template...` → `Template created successfully!` 또는 `Failed to create template! Try again later.`
* 업데이트: `Updating template...`
* 삭제 실패: `Failed to delete template. Try again later`
[템플릿](/features/templates) 참고.
## 발송 문제 [#발송-문제]
### 발송 버튼 비활성 / Send emails에 카운트 없음 [#발송-버튼-비활성--send-emails에-카운트-없음]
* **Template** 선택
* 셀당 유효한 **단일** 이메일이 있는 **Recipient column** 선택
* 볼 수 있는 가드 토스트: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### 캠페인 시작 실패 [#캠페인-시작-실패]
토스트: `Failed to create campaign. Please try again.`
* 한 번 재시도
* **Daily quota**가 0이 아닌지 확인
* API 연결 확인(위 참고)
### 행에 ⚠️ Failed [#행에-️-failed]
해당 행에서 발송 오류(잘못된 주소, Gmail 거부, 일시적 할당량 등). 데이터 수정 후 남은 행에 새 캠페인 시작, 또는 [캠페인 중지](/features/stopping-a-campaign) 참고.
### 테스트 이메일 실패 [#테스트-이메일-실패]
* `Configure your preview first` — 미리보기 To를 위해 template + recipient 선택
* `Failed to send test email. Please check your email settings.` — 필요 시 Gmail 재승인 후 재시도
## 추적 [#추적]
* 열림은 수신자 클라이언트가 원격 이미지를 로드해야 함
* **🔄 Refresh Tracking** 실행 — `Tracking info synced` 또는 `No active campaigns` 예상
* **👀 Opened** 상태는 픽셀이 로드될 때만 표시
[이메일 추적](/features/email-tracking) 참고.
## 할당량 및 브랜딩 [#할당량-및-브랜딩]
* 사이드바 **N left** = `min(MailG 잔여, Gmail 잔여)`
* Professional이어도 무료 `@gmail.com`은 Google이 보통 하루 약 500통 근처로 제한
* 결제 후에도 워터마크 → 결제 이메일 = Sheets 계정; 대화상자 다시 열기
[일일 할당량 및 리뷰](/help/daily-quota-and-reviews) 및 [브랜딩 제거](/features/remove-branding) 참고.
## 예약이 지연되지 않음 [#예약이-지연되지-않음]
약 **15초** 이내 시간은 지연 🗓️ 예약이 아니라 **즉시** 발송(🚀 열)으로 처리됩니다. 더 미래 시간을 선택하세요.
## 여전히 막히나요? [#여전히-막히나요]
전체 FAQ: [FAQ](/help/faq) · 이메일 [contact@mailg.io](mailto:contact@mailg.io) · 사이트 [app.mailg.io/help](https://www.mailg.io/ko/help)
# 일일 할당량 및 리뷰 (/ko/help/daily-quota-and-reviews)
root 사이드바는 계정 데이터가 로드되면 발송 용량을 표시합니다.
## Daily quota 블록 [#daily-quota-블록]
정확한 UI:
* 라벨: **Daily quota**
* 남은 수: **N left**
* 플랜 줄: **Your plan sends up to TOTAL/day**
**Remaining**은 다음 중 최소값:
1. 당일 MailG 플랜 잔여
2. 계정의 Gmail 발송 잔여 할당량
이론상 MailG에 여유가 있어도 Gmail에 막힐 수 있습니다. [계정 및 결제](/help/account-and-billing)도 참고.
## 무료 플랜 CTA [#무료-플랜-cta]
구독하지 않으면 사이드바에 다음이 표시될 수 있습니다:
* **Leave a 5★ review for +N/day free**(API가 따로 지정하지 않으면 기본 보너스 **+50/day**)
* **Or upgrade your plan**
리뷰 CTA 클릭 시 **Free Quota upgrade** 열림:
* 제목: **Free Quota upgrade**
* 본문: 5-star 리뷰를 남기면 **+N emails/day** 무료 할당량 업그레이드
* 버튼: **Not now** | **Leave a 5★ review**
리뷰 URL이 구성되지 않으면 **Leave a 5★ review**는 비활성 — **Upgrade to Pro** / 요금 페이지 사용.
## Pro로 업그레이드 [#pro로-업그레이드]
Footer 버튼(무료 계정): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
유료 플랜이 현재 제품에서 잠금 해제하는 것과 일치합니다.
## 관련 [#관련]
* [브랜딩 제거](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# 계정 및 결제 (/ko/help/account-and-billing)
MailG 결제는 Sheets의 **Google 계정 이메일**에 연결됩니다. 할당량이 부가 기능에서 잠금 해제되려면 항상 같은 주소로 결제하세요.
## 플랜 및 일일 할당량 [#플랜-및-일일-할당량]
| 플랜 | 일일 할당량 | 참고 |
| ------------ | ------ | ---------------- |
| Free | 50 | 핵심 병합, 열림 추적, 예약 |
| Personal | 250 | 성장하는 목록용 인기 플랜 |
| Professional | 1,500 | 최고 정기 할당량 |
| Lifetime | 1,500 | 일회성 구매 |
가격과 결제 주기는 [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=ko)에 있습니다(EUR 및 USD).
유료 권한으로 추가 잠금 해제:
* 기본이 아닌 [send pacing](/features/send-pacing)(**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
실제 발송량은 `min(MailG 일일 할당량, Gmail 남은 할당량)`입니다.
## 업그레이드 방법 [#업그레이드-방법]
1. [요금](https://app.mailg.io/pricing?lang=ko) 페이지 열기(부가 기능 **Upgrade to Pro** 링크와 동일).
2. 플랜 선택 후 Sheets Google 이메일로 Stripe Checkout 완료.
3. Sheets에서 MailG를 다시 열어 계정 새로고침으로 새 한도 반영.
## 구독 취소 또는 변경 [#구독-취소-또는-변경]
구독 / 요금 흐름에 연결된 Stripe 고객 포털에서 구독을 취소하거나 변경할 수 있습니다.
* 주기 중 취소해도 Premium 기능은 유료 기간 종료까지 유지
* 취소가 적용된 후에는 다시 청구되지 않음
## 환불 [#환불]
구매 후 **30일** 이내 Premium 구독을 취소하면 [contact@mailg.io](mailto:contact@mailg.io)로 전액 환불을 요청할 수 있습니다.
## 청구서 [#청구서]
Stripe가 성공 결제 영수증을 이메일로 보냅니다. 구독 관리용 Stripe 고객 포털에서 청구서를 다운로드할 수도 있습니다.
## FAQ 요약 [#faq-요약]
**MailG가 Google Workspace에 포함되나요?**\
아니요. MailG는 Google과 독립적입니다. Workspace 구독에 MailG가 포함되지 않습니다.
**어떤 결제 수단을 받나요?**\
주요 카드, Google Pay, Apple Pay(Stripe 경유). PayPal은 지원하지 않습니다.
**결제했는데 무료 한도 / 워터마크가 보임**\
거의 항상 이메일 불일치입니다. 결제 이메일 = Sheets 계정 이메일 확인 후 부가 기능 다시 열기. 계속되면 두 이메일과 함께 지원팀에 문의.
**무료 Gmail이 하루 약 500통으로 제한되는 이유는?**\
MailG Professional은 하루 1,500통까지 허용하지만, Google 자체가 무료 `@gmail.com` 계정을 하루 약 500통 근처로 제한합니다. Google Workspace 계정은 더 높을 수 있습니다. Gmail 제공자 한도이며 MailG 한도가 아닙니다.
# 캠페인 예약 (/ko/features/campaign-scheduling)
나중에 MailG가 시작하길 원하면 **Schedule send**를 사용하세요. 무료·유료 플랜 모두에서 사용 가능합니다.
## 예약 방법 [#예약-방법]
1. 발송 버튼이 활성화되도록 template과 수신자 구성.
2. 발송 메뉴(chevron) → **Schedule send**.
3. 대화상자 제목: **Schedule send**
4. 설명: `Pick date & time to schedule sending`
5. 요약 줄: 선택한 날짜/시간부터 N통 발송 예약
6. 날짜 선택기와 **Hour** / **Minute** 사용(placeholder `Hour`, `Min`).
7. **Schedule Send**로 확인(또는 **Cancel**).
기본 제안은 약 **60분 후**, 다음 **15분** 단위로 맞춤.
## 즉시 vs 예약 [#즉시-vs-예약]
약 **15초** 이내 시간은 지연 🗓️ 예약이 아니라 **즉시** 발송(🚀 열 헤더)으로 처리됩니다. 지연 발송이 필요하면 더 미래 시간을 선택하세요.
검증 토스트: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
성공 토스트: 캠페인 예약됨; N통이 선택한 시간에 시작.
## 시트 열 [#시트-열]
예약 캠페인은 다음 형태의 열 헤더를 만듭니다:
```text
🗓️ Template name (yyyy/MM/dd)
```
즉시 발송은 🗓️ 대신 🚀를 사용합니다.
행은 **🗓️ Scheduled**로 시작했다가 큐 실행 시 \*\*⏳ Sending…\*\*으로 바뀝니다.
## 예약 후 [#예약-후]
* 부가 기능 소유 Google 계정이 스프레드시트에 접근할 수 있게 유지
* 발송 시작 후 추적과 pacing은 그대로 적용
* **Manage Schedule** UI 없음 — [캠페인 중지](/features/stopping-a-campaign) 참고
## 관련 [#관련]
* [미리보기 및 테스트](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# 다중 수신자 (/ko/features/multiple-recipients)
전용 시트 열로 행마다 참조 수신자를 추가할 수 있습니다.
## 수신자 열 (받는 사람) [#수신자-열-받는-사람]
사이드바에서 **Recipient column** 선택.
발송 버튼 카운트와 열 검증을 위해 MailG는 셀이 **단일** 이메일 주소일 때 유효로 봅니다. 행당 주 To 주소 하나를 권장합니다.
## CC 및 BCC 열 [#cc-및-bcc-열]
1. 시트에 열 추가(예: `CC`, `BCC`).
2. 셀에 이메일(또는 Gmail이 허용하는 목록) 입력.
3. **More options**를 열고 **CC** / **BCC** 매핑.
4. 발송 시 해당 값이 Gmail로 전달됩니다.
미리보기 창은 **From**, **To**, **Subject**, 본문만 표시합니다. 매핑해도 CC/BCC 줄은 **표시되지 않습니다**. CC/BCC 배달 확인이 필요하면 **Send me a test email**로 검증하세요.
## 할당량: MailG vs Gmail [#할당량-mailg-vs-gmail]
* **MailG 일일 할당량**은 처리된 **캠페인 행** 수를 셉니다.
* **Gmail 발송 한도**는 **수신자**(해당 발송에서 Gmail이 허용하는 To + CC + BCC 주소) 수를 셉니다.
MailG 할당량이 남아도 Gmail 한도에 걸릴 수 있습니다.
## 팁 [#팁]
* 서로 이메일을 보이면 안 되면 **BCC** 권장
* 사용하지 않으면 CC/BCC 매핑 해제
* 대량 발송 전 주소 검증
# Attachments (/ko/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# 기능 개요 (/ko/features/features-overview)
부가 기능이 현재 지원하는 기능:
| 기능 | 문서 |
| -------------------------- | --------------------------------------------- |
| 시작 대화상자 / 빈 시트 / mock data | [시작 대화상자 둘러보기](/getting-started/start-dialog) |
| 템플릿(만들기 / 관리 / 수정 / 삭제) | [템플릿](/features/templates) |
| **본문**의 병합 태그 | [병합 태그](/features/merge-tags) |
| 서식 있는 텍스트 툴바 | [서식 있는 이메일](/features/rich-text-emails) |
| 링크(이미지 임베드 아님) | [이미지](/features/images) |
| 미리보기 + 테스트 이메일 | [미리보기 및 테스트](/features/preview-and-test) |
| Schedule send | [캠페인 예약](/features/campaign-scheduling) |
| Send pacing(유료) | [Send pacing](/features/send-pacing) |
| CC / BCC 열 | [다중 수신자](/features/multiple-recipients) |
| Track emails | [이메일 추적](/features/email-tracking) |
| Sender name 및 reply-to | [발신자 맞춤 설정](/features/customized-sender) |
| Remove branding(유료) | [브랜딩 제거](/features/remove-branding) |
| 남은 행 중지 | [캠페인 중지](/features/stopping-a-campaign) |
| 일일 할당량 + 리뷰 보너스 | [일일 할당량 및 리뷰](/help/daily-quota-and-reviews) |
## 유료 vs 무료 [#유료-vs-무료]
유료에서 잠금 해제:
* 기본이 아닌 [send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* 더 높은 [일일 할당량](/help/account-and-billing)
**Schedule send**, **Track emails**, 템플릿 도구는 유료 업그레이드 없이 사용할 수 있습니다.
## 알려진 제한(솔직하게) [#알려진-제한솔직하게]
| 주제 | 제품 상태 |
| ----------------------- | ------------------ |
| 제목 병합 태그 | 발송 시 적용 안 됨 — 본문만 |
| Attachments 열 | UI만 — 발송 시 첨부 안 됨 |
| 이미지 임베드 | 편집기 컨트롤 없음 — 링크 사용 |
| 미리보기 CC/BCC 줄 | 미리보기 UI에 표시 안 됨 |
| Manage Schedule / Pause | 미출시 — 상태 우회 방법 사용 |
## 추후 예정 [#추후-예정]
구독 해지 링크, 클릭 추적, 팀 공유 시트, 전용 캠페인 관리 UI는 출시 시 추가됩니다.
# 이메일 추적 (/ko/features/email-tracking)
MailG는 작은 보이지 않는 픽셀로 열림을 기록할 수 있습니다.
## 추적 활성화 [#추적-활성화]
사이드바에서 **Track emails**를 켜 두세요(새 작업 기본값은 켜짐).
Tooltip: `Track emails opened with a tiny pixel`
도움말 아이콘은 **Email tracking**을 엽니다:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
버튼: **Got it**
## 시트 상태 [#시트-상태]
| 상태 | 의미 |
| ------------- | --------------- |
| 🗓️ Scheduled | 예약된 시작 대기 |
| ⏳ Sending… | 현재 처리 중 |
| ✉️ Sent | 해당 행 Gmail로 전달됨 |
| ⚠️ Failed | 해당 행 발송 오류 |
| 👀 Opened | 열림 픽셀 로드됨 |
캠페인 열 헤더는 `🚀 Template name (yyyy/MM/dd)` 또는 예약 시 `🗓️ …` 형태입니다.
## 추적 새로고침 [#추적-새로고침]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Apps Script 알림:
* `Tracking info synced`
* `No active campaigns`
## 제한 [#제한]
* 클라이언트가 원격 이미지를 로드해야 함
* 프라이버시 프록시가 열림을 숨길 수 있음
* 열림만 — 링크 클릭은 아님
## 관련 [#관련]
* [캠페인 예약](/features/campaign-scheduling)
* [FAQ](/help/faq)
# 병합 태그 (/ko/features/merge-tags)
병합 태그로 수신자마다 개인화된 **본문**을 보낼 수 있습니다. 태그는 **정확한 열 헤더**를 중괄호 두 개로 감싼 형태입니다.
## 구문 [#구문]
시트에 `First Name` 열이 있으면:
```text
{{First Name}}
```
본문 예시:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## 병합 태그가 동작하는 곳 [#병합-태그가-동작하는-곳]
| 필드 | 발송 시 병합? |
| ------- | ------------------------- |
| 이메일 본문 | **예** — 행마다 변수 주입 |
| 이메일 제목 | **아니오** — 템플릿에 저장된 제목 그대로 |
| 미리보기 본문 | **예** — 활성 행 기준 |
| 미리보기 제목 | **아니오** — 템플릿 제목 그대로 표시 |
제목 병합이 출시될 때까지 개인화는 본문에 넣으세요.
## 태그 삽입 [#태그-삽입]
편집기 툴바에서 **Merge Tag**를 엽니다. 활성 시트의 헤더 목록이 표시됩니다. 비어 있을 때: `No sheet columns found`.
삽입된 텍스트는 열 이름을 중괄호 두 개로 감쌉니다.
## 참고 사항 [#참고-사항]
* 헤더는 대소문자 구분(`Name` ≠ `name`)
* 빈 셀은 빈 문자열로 삽입
* 본문에서 같은 태그를 여러 번 사용 가능
* 수신자 / CC / BCC는 병합 태그가 아니라 **More options**에서 선택
## 다음 [#다음]
[서식 있는 이메일](/features/rich-text-emails) 및 [미리보기 및 테스트](/features/preview-and-test) 참고.
# 서식 있는 이메일 (/ko/features/rich-text-emails)
MailG 템플릿은 TipTap 서식 편집기를 사용합니다. 생성된 HTML이 Gmail로 전달됩니다.
본문 placeholder: `Write your email…`
## 툴바 목록(정확한 UI) [#툴바-목록정확한-ui]
| 그룹 | 컨트롤 |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt**(툴바 프리셋) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | 프리셋 견본 + 네이티브 색 선택기 + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — URL 필드 placeholder `https://example.com`, **Apply**(및 unlink) |
| History | **Undo**, **Redo** |
## 편집기에 없는 것 [#편집기에-없는-것]
다음 TipTap 기능은 비활성/없음:
* 제목, 코드, 코드 블록, 인용, 구분선
* 이미지 삽입 / Drive 미디어 선택기 — [이미지](/features/images) 참고
## 하이퍼링크 [#하이퍼링크]
**Insert link**로 URL과 표시 텍스트 설정. 원시 URL보다 명확한 링크 텍스트 권장.
## 팁 [#팁]
* 중괄호를 직접 치지 말고 **Merge Tag** 사용
* 발송 전 여러 행 미리보기 — [미리보기 및 테스트](/features/preview-and-test)
* Word/Docs에서 붙여 넣은 거대한 마크업은 피하고 MailG에서 서식 다시 적용해 HTML 정리
# MailG 브랜딩 제거 (/ko/features/remove-branding)
무료 캠페인에는 이메일 footer에 작은 MailG 워터마크가 포함될 수 있습니다. 유료 구독자는 끌 수 있습니다.
## 브랜딩 제거 방법 [#브랜딩-제거-방법]
1. 활성 유료 플랜(Personal, Professional, Lifetime)인지 확인.
2. 캠페인 사이드바를 엽니다.
3. **Remove branding**을 켭니다.
4. 행을 미리 보고 워터마크가 사라졌는지 확인한 뒤 발송.
결제 후에도 브랜딩이 보이면:
* 결제에 **Google Sheets와 같은 이메일**을 사용했는지 확인
* 부가 기능을 다시 열어 API에서 권한 새로고침
* Google 계정 이메일과 함께 [contact@mailg.io](mailto:contact@mailg.io)로 문의
[계정 및 결제](/help/account-and-billing) 참고.
# 이미지 (/ko/features/images)
MailG 편집기에는 **이미지 삽입 버튼**과 Google Drive 미디어 선택기가 없습니다. TipTap Image 확장은 활성화되지 않았습니다.
## 현재 가능한 방법 [#현재-가능한-방법]
툴바에서 **Insert link** 사용:
1. 이미지(또는 파일)를 공개 URL에 호스팅하거나 Drive 링크 공유.
2. 텍스트 선택(또는 커서 위치) → **Insert link**.
3. URL 붙여넣기(placeholder `https://example.com`) → **Apply**.
수신자는 링크를 열어 이미지나 파일을 봅니다. 편집기가 `![]()
` 태그를 임베드하지 않습니다.
## 팁 [#팁]
* 작은 파일과 명확한 링크 텍스트(「스크린샷 보기」) 권장
* 로그인이 필요한 링크는 수신자에게 실패
* **Send me a test email**로 확인
## 추후 예정 [#추후-예정]
1급 이미지 임베드 / Drive 선택기는 나중에 출시될 수 있습니다. 그때까지는 하이퍼링크가 지원 경로입니다.
# 템플릿 (/ko/features/templates)
템플릿은 캠페인마다 재사용하는 제목과 서식 있는 본문을 저장합니다. Google 계정으로 MailG API에 저장됩니다.
## 템플릿 만들기 [#템플릿-만들기]
1. root 화면에서 **New Template** 클릭.
2. 입력:
* **Template Name**
* **Email Subject**
* 본문(서식 편집기 — [서식 있는 이메일](/features/rich-text-emails) 참고)
3. **Save Template** 클릭(작업 중 **Saving...** 표시).
토스트:
* 로딩: `Creating Template...`
* 성공: `Template created successfully!`
* 오류: `Failed to create template! Try again later.`
**Fill with mock data**의 데모 템플릿: 이름 **My First Template**, 제목 `I found a mail merge tool for Gmail`.
## 템플릿 관리 [#템플릿-관리]
템플릿 선택 옆 템플릿 아이콘 열기(tooltip **Manage templates**).
표 열:
| 열 | 내용 |
| ----------------- | ------ |
| **Name** | 템플릿 이름 |
| **Email Subject** | 제목 줄 |
| **Created At** | 생성일 |
| **Actions** | 행 메뉴 |
행 메뉴: **Edit** | **Delete**
Footer: **Back**
삭제 토스트: deleting template NAME → template NAME deleted successfully(또는 실패 메시지).
## 템플릿 수정 [#템플릿-수정]
manage에서 **Edit** 열기, 또는 미리보기 툴바에서 **Edit template** 클릭.
만들기와 동일한 필드. **Save Template**로 템플릿 업데이트.
업데이트 흐름은 로딩 토스트(`Updating template...`)를 표시합니다. 완료될 때까지 폼에 머물고, 자동으로 돌아가지 않으면 **Cancel** 또는 **Back**을 사용하세요.
## 제목 vs 본문 [#제목-vs-본문]
* **본문**은 [병합 태그](/features/merge-tags) 지원 — 발송 시 행마다 주입됩니다.
* **Email Subject**는 현재 저장된 그대로 발송됩니다(제목의 병합 태그는 **아직** 치환되지 않음). 개인화는 본문에 넣거나 고정 제목을 사용하세요.
## 관련 [#관련]
* [미리보기 및 테스트](/features/preview-and-test)
* [시작 대화상자 둘러보기](/getting-started/start-dialog)
# 미리보기 및 테스트 (/ko/features/preview-and-test)
미리보기 창(root 대화상자 오른쪽)은 활성 시트 행 기준으로 메시지가 어떻게 보이는지 보여 줍니다.
## 미리보기에 표시되는 내용 [#미리보기에-표시되는-내용]
| 필드 | 내용 |
| ------------ | ------------------------------------------------------------ |
| **From:** | 로그인한 Google 계정 이메일 |
| **To:** | 활성 행의 **Recipient column** 값, 또는 `Select a recipient column` |
| **Subject:** | 저장된 템플릿 제목(병합 치환 없음) |
| 본문 | 해당 행에 병합 태그가 적용된 템플릿 본문 |
**Remove branding**이 꺼져 있으면 미리보기에 MailG 워터마크 footer(`made and sent with` / **MailG** / `Email Marketing from Gmail`)가 포함됩니다.
## 표시되지 않는 것 [#표시되지-않는-것]
* **CC** / **BCC** 줄은 미리보기 UI에 렌더링되지 않습니다(**More options**에서 매핑해도). 발송 시에는 적용됩니다.
* 첨부 열 값은 미리보기에 표시되지 않습니다.
## 행 탐색 [#행-탐색]
미리보기 툴바:
* **Edit template** — update-template 화면 열기
* **Previous recipient** / **Next recipient** — 데이터 행 이동(tooltip에 시트 행 번호 포함 가능; 헤더는 1행, 첫 연락처는 2행)
## 테스트 이메일 받기 [#테스트-이메일-받기]
1. 미리보기가 유효하도록 template + recipient column 구성.
2. 발송 메뉴(chevron) → **Send me a test email**.
3. 처리 중 오버레이: `Sending test email…`
4. 성공 토스트: `Test email sent successfully. Check your inbox.`
5. 실패 토스트: `Failed to send test email. Please check your email settings.`
6. 미리보기 미완료 시: `Configure your preview first`
테스트는 **본인** Google 계정 받은편지함으로, 활성 미리보기 행의 병합 본문을 사용합니다.
## 팁 [#팁]
* 전체 발송 전 화살표로 여러 행 확인
* 미리보기에서 branding / no branding 확인
* **Schedule send** 또는 대량 **Send N email(s)** 전에 항상 테스트
## 관련 [#관련]
* [병합 태그](/features/merge-tags)
* [메일 병합 튜토리얼](/getting-started/mail-merge-tutorial)
# 발송 속도 조절 (/ko/features/send-pacing)
Send pacing은 메시지 사이에 지연을 넣어 대량 캠페인이 한 번에 몰려 나가지 않게 합니다.
**Steady pace**와 **Jittered gaps**는 활성 유료 MailG 구독이 필요합니다. 무료 계정은 **Burst send**만 사용할 수 있습니다.
## 설정 위치 [#설정-위치]
하단 톱니 열기(tooltip **Send pacing**). 화면 제목: **Send pacing**.
**Dispatch mode**에서 이메일 간격 방식 선택. **Gap between emails**는 **초** 단위(0–60). 무료 계정에는 **Pro features**와 잠금 문구: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
새 작업 기본값: **Burst send**, gap **10s**(burst를 벗어나기 전까지 gap 무시).
## 모드 [#모드]
| 모드(UI 라벨) | 동작 |
| ------------------ | ------------------------ |
| **Burst send**(기본) | 할당량 허용 범위에서 최대한 빠르게 발송 |
| **Steady pace** | 각 이메일 사이 고정 gap 대기 |
| **Jittered gaps** | 0부터 선택한 최대값 사이 랜덤 gap 대기 |
## pacing을 쓰는 이유 [#pacing을-쓰는-이유]
* 메일박스 제공자에게 갑작스러운 대량 발송으로 보일 위험 감소
* 긴 목록을 조용한 발송 시간대에 분산
* 계정 유형에 맞는 Gmail 편안한 구간 유지
## 참고 [#참고]
* Pacing은 작업과 함께 저장되는 캠페인 설정 — 새 발송은 현재 구성 사용
* 큰 목록에 긴 gap은 총 캠페인 시간을 크게 늘림
* 실제 속도는 MailG 일일 할당량 **과** Gmail 남은 발송 할당량으로 제한
* 경쟁 도구는 분 단위 지연을 쓰는 경우가 있음 — MailG는 **초** 사용
## 관련 [#관련]
* 실행 중 gap이 너무 크면 [캠페인 중지](/features/stopping-a-campaign)
* [계정 및 결제](/help/account-and-billing)
# 캠페인 중지 (/ko/features/stopping-a-campaign)
MailG에는 아직 일부 경쟁 제품처럼 전용 **Manage Schedule**, **Abort**, **Pause** 화면이 없습니다. 그래도 **남은** 행의 발송은 막을 수 있습니다.
## 발송이 처리할 행을 결정하는 방식 [#발송이-처리할-행을-결정하는-방식]
발송 루프는 캠페인 열 상태가 아직 발송 가능한 행만 처리합니다:
* ⏳ Sending… / 레거시 `Pending...`
* 🗓️ Scheduled / 레거시 `Scheduled`
이미 **✉️ Sent**, **⚠️ Failed**, **👀 Opened**인 행은 건너뜁니다.
## 남은 행 중지(현실적인 우회) [#남은-행-중지현실적인-우회]
대량 캠페인에서는 빠르게 조치하세요:
1. 스프레드시트를 엽니다.
2. 캠페인 상태 열에서 **보내면 안 되는** 행의 상태를 지우거나 변경합니다(예: 셀 값 삭제, 또는 `Stopped` 같은 비발송 라벨 설정).
3. 이미 **✉️ Sent**인 행은 그대로 둡니다 — 해당 메시지는 이미 나갔습니다.
지우거나 변경한 행은 더 이상 발송 가능 상태와 맞지 않아 다음 패스에서 큐가 건너뜁니다.
계정에서 이미 나간 Gmail 메시지는 MailG로 취소할 수 없습니다. 중지는 아직 처리되지 않은 행만 보호합니다.
## 아직 시작하지 않은 예약 캠페인 [#아직-시작하지-않은-예약-캠페인]
모든 행이 여전히 **🗓️ Scheduled**이고 시작 시간이 되지 않았다면, 해당 상태(또는 캠페인 열)를 지우면 시간이 되어도 큐가 가져가지 않습니다.
확실하지 않으면 스프레드시트 URL과 캠페인 정보와 함께 [contact@mailg.io](mailto:contact@mailg.io)로 문의하세요.
## 관련 [#관련]
* [캠페인 예약](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# 발신자 맞춤 설정 (/ko/features/customized-sender)
기본적으로 Gmail은 MailG를 승인한 Google 계정에서 발송합니다. 받은편지함에 보이는 이름과 회신 주소는 맞출 수 있습니다.
## 발신자 이름 [#발신자-이름]
1. 캠페인 사이드바에서 **More options**를 엽니다.
2. **Sender name** 설정(placeholder `John Doe (Optional)`).
3. 수신자는 받은편지함에서 해당 표시 이름을 봅니다(Gmail 표시 규칙 적용).
## 회신 주소 [#회신-주소]
회신이 발송 계정이 아닌 다른 곳으로 가야 하면 **Reply to address** 설정(placeholder `john@doe.com (Optional)`).
## 참고 [#참고]
* 실제 From 주소는 승인된 Gmail 계정 — 다른 사서함으로 위장 불가
* 잘못된 reply-to는 배달·회신 문제 유발 — 본인이 관리하는 사서함 사용
* 미리보기 \*\*From:\*\*은 로그인 이메일; reply-to는 **Send me a test email**로 확인
* [미리보기 및 테스트](/features/preview-and-test) 참고
# 시작 대화상자 둘러보기 (/ko/getting-started/start-dialog)
**Extensions → MailG for Gmail → 🚀 Start**로 부가 기능을 엽니다. 제목이 **MailG for Gmail**인 900×600 대화상자가 열립니다.
## 화면 [#화면]
| 화면 | 접근 방법 | 용도 |
| ---------------- | ------------------------------------- | ---------------------- |
| Root(작성기) | 로드 후 기본 | 템플릿 + 수신자 선택, 미리보기, 발송 |
| Create template | **New Template** | 이름, 제목, 본문 |
| Manage templates | 템플릿 아이콘(tooltip **Manage templates**) | 목록, 수정, 삭제 |
| Update template | **Edit template** 또는 행 **Edit** | 기존 템플릿 수정 |
| Settings | 하단 톱니(tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | 유효한 이메일 열 없음 | 연락처 또는 mock data 추가 안내 |
| API / 시트 오류 | 로드 실패 | 재시도 안내 |
## Root 레이아웃 [#root-레이아웃]
세 영역:
1. **Sidebar**(왼쪽) — template, recipient column, **More options**, tracking, branding, quota
2. **Preview**(오른쪽) — From / To / Subject / body, 행 탐색, **Edit template**
3. **Footer** — 발송 버튼, 발송 메뉴, **Upgrade to Pro**(무료), settings, help
## 사이드바 컨트롤(정확한 라벨) [#사이드바-컨트롤정확한-라벨]
* **New Template**
* **Template**(select) — placeholder `Select` 또는 `No templates found`
* **Recipient column** — `A - Email` 같은 옵션; 비어 있을 때: `No valid email columns found.`
* **More options** — **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address** 펼침
* **Track emails**(기본 켜짐)
* **Remove branding**(유료)
* **Daily quota** — 남은 수 "N left" 및 플랜 줄 "Your plan sends up to TOTAL/day"
무료 계정에는 **Leave a 5★ review for +N/day free** 및 **Or upgrade your plan**도 표시됩니다. [일일 할당량 및 리뷰](/help/daily-quota-and-reviews) 참고.
## 하단 발송 컨트롤 [#하단-발송-컨트롤]
| 컨트롤 | 라벨 |
| ----------- | ------------------------------------------------------------------------------------- |
| 기본 버튼 | **Send N email(s)**(또는 카운트 0일 때 **Send emails**) |
| 발송 메뉴 | **Send me a test email** |
| 발송 메뉴 | **Schedule send** |
| Upgrade(무료) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| 톱니 | tooltip **Send pacing** |
| Help | tooltip **Help** — 대화상자 내 체크리스트 열기 |
### Need help? 체크리스트 [#need-help-체크리스트]
1. 템플릿과 수신자 열 선택
2. 화살표로 각 행 미리보기
3. 먼저 본인에게 테스트 이메일 발송
4. Send를 클릭해 시트에서 병합 발송
버튼: **Open docs**([docs.mailg.io](https://docs.mailg.io)) | **View pricing**(가능한 경우) | **Close**
## 빈 시트 [#빈-시트]
MailG가 유효한 이메일 열을 찾지 못하면:
* 제목: **No email address found in your sheet**
* 작업: **Close** | **Fill with mock data**
Mock data는 `Email`, `First Name`, `Last Name`, `Company` 헤더를 채우고 **My First Template**을 만들 수 있습니다.
## 오류 화면 [#오류-화면]
| 제목 | 발생 시점 |
| --------------------------------- | ------------- |
| **Could not reach the MailG API** | API / 네트워크 실패 |
| **Could not read your sheet** | 시트 읽기 실패 |
## 다음 [#다음]
# 설치 (/ko/getting-started/installation)
두 단계입니다: 부가 기능을 설치한 뒤 Sheets에서 실행합니다.
## MailG 설치 [#mailg-설치]
1. [Google Workspace Marketplace의 MailG 목록](https://workspace.google.com/marketplace/app/mailg)을 엽니다.
2. **Install**을 클릭합니다.
3. 설치를 소유할 Google 계정을 선택합니다.
4. 권한을 검토하고 **Allow**를 클릭합니다.
설치는 보통 15초 이내에 완료됩니다. 부가 기능이 설치되었다는 확인 메시지가 표시됩니다.
해당 지역에서 Marketplace 목록이 아직 공개되지 않았다면 [www.mailg.io](https://www.mailg.io)의 설치 CTA를 사용하거나 [contact@mailg.io](mailto:contact@mailg.io)로 문의하세요.
## Google Sheets에서 MailG 실행 [#google-sheets에서-mailg-실행]
1. [Google Sheets](https://sheets.google.com)를 엽니다(Sheets가 이미 열려 있었다면 새로고침).
2. Extensions가 로드될 때까지 몇 초 기다립니다(보통 약 10–15초).
3. **Extensions → MailG for Gmail → 🚀 Start**로 이동합니다.
나중에는 전체 대화상자를 열지 않고 열림 상태를 동기화하려면 **Extensions → MailG for Gmail → 🔄 Refresh Tracking**을 실행할 수 있습니다.
## 설치 문제 [#설치-문제]
다음은 MailG 버그가 아니라 흔한 Google Workspace 특성입니다.
### "설치 완료" 팝업이 나타나지 않음 [#설치-완료-팝업이-나타나지-않음]
여러 Google 계정에 로그인되어 있고, 예상한 계정으로 설치되지 않았을 때 자주 발생합니다.
**해결 방법:** 시크릿/프라이빗 창을 열고 대상 계정만 로그인한 뒤 Marketplace에서 다시 설치하세요.
### Extensions 아래에 MailG가 보이지 않음 [#extensions-아래에-mailg가-보이지-않음]
1. 스프레드시트를 새로고침합니다.
2. 부가 기능이 로드될 때까지 약 10–15초 기다립니다.
3. MailG를 설치한 Google 계정과 같은 계정인지 확인합니다.
4. 여전히 보이지 않으면 다른 스프레드시트를 열거나 브라우저 캐시를 지워 보세요.
## 셀프 호스팅 / 맞춤 배포 [#셀프-호스팅--맞춤-배포]
Marketplace 설치는 미리 구성되어 있습니다. MailG를 직접 배포하는 경우 Apps Script 스크립트 속성을 설정하세요.
| 속성 | 값 |
| ------------- | ----------------------- |
| `APP_URL` | MailG API의 공개 HTTPS URL |
| `APP_API_KEY` | API 서버와 동일한 키 |
부가 기능은 Google 서버에서 `localhost`에 접근할 수 없습니다 — 로컬 테스트에는 Cloudflare Tunnel, ngrok 등의 터널을 사용하세요.
## 다음 [#다음]
[메일 병합 튜토리얼](/getting-started/mail-merge-tutorial)을 계속 진행하세요.
# 메일 병합 튜토리얼 (/ko/getting-started/mail-merge-tutorial)
이 안내는 **MailG for Gmail** 시작 대화상자와 동일한 흐름입니다.
## 1. MailG 열기 [#1-mailg-열기]
**Extensions → MailG for Gmail → 🚀 Start**.
**No email address found in your sheet**가 보이면 실제 이메일을 추가하거나 **Fill with mock data**를 클릭하세요(샘플 행과 종종 **My First Template** 생성). [시작 대화상자 둘러보기](/getting-started/start-dialog) 참고.
## 2. 템플릿 만들기 또는 선택 [#2-템플릿-만들기-또는-선택]
1. **New Template**을 클릭하거나(**Template** 아래에서 기존 템플릿 선택).
2. **Template Name**과 **Email Subject** 설정(제목은 현재 **병합 치환되지 않음**).
3. 본문을 작성하고 **Merge Tag**로 [병합 태그](/features/merge-tags) 삽입.
4. **Save Template**.
본문 예시:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. 캠페인 구성 [#3-캠페인-구성]
사이드바에서:
1. **Recipient column** 선택(UI가 카운트하려면 셀에 유효한 단일 이메일이 있어야 함).
2. **More options**에서 **CC**, **BCC**, **Sender name**, **Reply to address** 설정.
3. 시트에 열림 상태를 원하면 **Track emails** 켜기(기본값).
4. 유료 플랜에서는 **Remove branding** 활성화.
**Attachments**는 **More options** 아래에 표시되지만, 아직 발송 시 파일이 첨부되지 않습니다. 본문에 Drive 링크나 URL을 넣으세요.
## 4. 미리보기 및 테스트 [#4-미리보기-및-테스트]
1. 이전/다음 화살표로 행을 이동합니다.
2. \*\*To:\*\*와 병합된 본문 확인(제목은 템플릿 제목 그대로 표시).
3. 발송 메뉴 → **Send me a test email**.
4. 받은편지함을 확인합니다.
자세히: [미리보기 및 테스트](/features/preview-and-test).
## 5. 발송 또는 예약 [#5-발송-또는-예약]
* 기본 버튼: 수신자가 카운트되면 **Send N email(s)**.
* 또는 발송 메뉴 → **Schedule send** → 날짜/시간 선택 → **Schedule Send**.
처리 중 오버레이: `Starting your campaign…` / 예약 확인 토스트.
MailG는 `🚀 My Template (yyyy/MM/dd)` 또는 예약 시 `🗓️ …` 같은 캠페인 열을 추가합니다.
행 상태:
| 상태 | 의미 |
| ------------- | ---------- |
| 🗓️ Scheduled | 시작 대기 |
| ⏳ Sending… | 처리 중 |
| ✉️ Sent | Gmail로 전달됨 |
| ⚠️ Failed | 오류 |
| 👀 Opened | 열림 픽셀 로드됨 |
## 흔한 실수 [#흔한-실수]
* 제목 태그로 개인화 기대 — 현재는 본문만
* 셀에 쉼표로 구분된 여러 주소 — UI는 카운트용으로 셀당 **하나**의 이메일만 검증
* 설치 계정과 다른 Google 계정 사용
* 일일 할당량 초과 — 사이드바 **Daily quota** 확인
## 팁 [#팁]
* 처음에는 하단 **Help** 체크리스트 사용
* mock data 후 실제 행 2–3개로 시작
* 열림 확인 후: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → 알림 `Tracking info synced`(또는 `No active campaigns`)
## 다음 [#다음]
# MailG란? (/ko/getting-started/what-is-mailg)
MailG는 Google Sheet를 메일 병합 캠페인으로 바꿉니다. 각 행은 수신자이고, 열 헤더는 **이메일 본문**의 병합 태그(헤더 이름을 중괄호 두 개로 감싼 형태)가 됩니다.
## 할 수 있는 것 [#할-수-있는-것]
* 클라우드에 저장되는 템플릿 만들기 (**Template Name**, **Email Subject**, 서식 있는 본문)
* 시트 헤더의 병합 태그로 **본문** 개인화
* 행 미리보기 및 **Send me a test email**
* **CC** / **BCC**, **Sender name**, **Reply to address** 매핑
* **Schedule send** 또는 즉시 발송
* 시트의 열림 상태 칩으로 **Track emails**
* 유료 플랜에서 **Send pacing** 제어
* 유료 플랜에서 **Remove branding**
* **Daily quota** 확인(선택적으로 무료 리뷰 보너스 신청)
## 구성 요소 [#구성-요소]
1. **Google Sheets 부가 기능** — **MailG for Gmail** 아래 대화상자
2. **MailG API** — 템플릿, 캠페인 메타데이터, 열림 추적, 권한
3. **본인 Gmail** — 승인된 계정의 `GmailApp`으로 발송되는 메시지
## 다음 단계 [#다음-단계]
# ติดต่อเรา (/th/contact-us)
## การเรียกเก็บเงินและการสมัครสมาชิก [#การเรียกเก็บเงินและการสมัครสมาชิก]
คุณสามารถจัดการการเปลี่ยนแปลงการสมัครสมาชิกส่วนใหญ่ได้จากพอร์ทัล Stripe ที่เชื่อมผ่าน [pricing](https://app.mailg.io/pricing?lang=th) สำหรับการคืนเงินหรือปัญหาการชำระเงิน โปรดส่งอีเมลถึงเรา
## เรื่องอื่นๆ [#เรื่องอื่นๆ]
ส่งอีเมลถึง **[contact@mailg.io](mailto:contact@mailg.io)**
เรามักตอบกลับภายในหนึ่งวันทำการ
## ลิงก์ที่มีประโยชน์ [#ลิงก์ที่มีประโยชน์]
* [เว็บไซต์](https://www.mailg.io)
* [ราคา](https://app.mailg.io/pricing?lang=th)
* [ความเป็นส่วนตัว](https://www.mailg.io/th/privacy)
* [ข้อกำหนด](https://www.mailg.io/th/terms)
* [หน้าแรกเอกสาร](/)
# เอกสาร MailG (/th)
MailG เป็น add-on ของ Google Sheets สำหรับ mail merge กับ Gmail เปิด **Extensions → MailG for Gmail → 🚀 Start** สร้างแม่แบบ ดูตัวอย่างแถว แล้วส่งหรือกำหนดเวลาจากบัญชี Gmail ของคุณเอง
## เริ่มต้นที่นี่ [#เริ่มต้นที่นี่]
## หัวข้อยอดนิยม [#หัวข้อยอดนิยม]
## ลิงก์ที่เป็นประโยชน์ [#ลิงก์ที่เป็นประโยชน์]
* เว็บไซต์: [www.mailg.io](https://www.mailg.io)
* เอกสาร: [docs.mailg.io/th](https://docs.mailg.io/th)
* ราคา: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=th)
* ติดต่อ: [contact@mailg.io](mailto:contact@mailg.io)
## สำหรับผู้ช่วย AI / LLM [#สำหรับผู้ช่วย-ai--llm]
ควรใช้เอนด์พอยต์ที่อ่านด้วยเครื่องเหล่านี้แทนการดึง HTML:
* [Agents hub](https://www.mailg.io/th/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/th/help/faq)
## การติดตั้งและเปิดใช้งาน [#การติดตั้งและเปิดใช้งาน]
**เปิด MailG อย่างไร?**\
**Extensions → MailG for Gmail → 🚀 Start** ดู [การติดตั้ง](/getting-started/installation)
**No email address found in your sheet**\
เพิ่มอีเมลในคอลัมน์ หรือคลิก **Fill with mock data** ดู [ทัวร์ Start dialog](/getting-started/start-dialog)
**Could not reach the MailG API**\
ตรวจเครือข่าย / URL API (self-hosted: `APP_URL` + `APP_API_KEY`) เปิดกล่องโต้ตอบใหม่หลังแก้ไข
## การส่ง [#การส่ง]
**อีเมลไม่ถูกส่ง**\
ตรวจ **Daily quota** สิทธิ์ Gmail และว่าเซลล์ **Recipient column** เป็นอีเมลเดียวที่ถูกต้อง ความล้มเหลวแสดง **⚠️ Failed**
**Merge tag ในหัวเรื่องใช้ได้ไหม?**\
ยังไม่ได้ มีเฉพาะ **body** ที่ merge ใช้หัวเรื่องคงที่หรือใส่การปรับแต่งใน body ดู [Merge tag](/features/merge-tags)
**แนบไฟล์ได้ไหม?**\
ตัวเลือก **Attachments** มีภายใต้ **More options** แต่ไฟล์ยังไม่ถูกแนบเมื่อส่ง ใช้ลิงก์แทน
**หยุดแคมเปญอย่างไร?**\
[หยุดแคมเปญ](/features/stopping-a-campaign) — ล้างสถานะที่ส่งได้ในแถวที่เหลือ
**ทำไมถูกจำกัดแม้ใช้ Professional?**\
MailG อาจอนุญาตถึง 1,500/วัน แต่ `@gmail.com` ฟรีมักถูก Google จำกัดใกล้ 500
## การติดตาม [#การติดตาม]
**ชีตยังบอก Sent หลังเปิดอ่าน**\
**🔄 Refresh Tracking** → คาดหวัง `Tracking info synced` ไคลเอนต์บางตัวไม่โหลดรูปภาพเลย
**คลิก?**\
ไม่ติดตาม **Track emails** = เปิดอ่านเท่านั้น
## โควตาและการเรียกเก็บเงิน [#โควตาและการเรียกเก็บเงิน]
ดู [โควตารายวันและรีวิว](/help/daily-quota-and-reviews) และ [บัญชีและการเรียกเก็บเงิน](/help/account-and-billing)
**Schedule send ต้องจ่ายเงินไหม?**\
ไม่ แบบชำระเงินปลดล็อกโควตาสูงขึ้น โหมด pacing และ **Remove branding**
## การแก้ปัญหา [#การแก้ปัญหา]
สำหรับการแก้ทีละขั้น (ข้อผิดพลาด API, ชีตว่าง, ปุ่มส่งปิด, แถวล้มเหลว, การติดตาม, โควตา, กำหนดเวลาไม่เลื่อน) ดู [การแก้ปัญหา](/help/troubleshooting)
Toast ที่อาจเห็น:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## ยังติดอยู่? [#ยังติดอยู่]
[การแก้ปัญหา](/help/troubleshooting) · เอกสาร [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# การแก้ปัญหา (/th/help/troubleshooting)
การแก้ด่วนสำหรับข้อความและสถานะที่เห็นใน add-on
## กล่องโต้ตอบโหลดไม่ได้ [#กล่องโต้ตอบโหลดไม่ได้]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
Start dialog เรียก backend MailG ไม่ได้
* ยืนยันว่าออนไลน์
* ติดตั้ง Marketplace: รอสักครู่แล้วเปิด **🚀 Start** ใหม่
* Self-hosted: ตรวจ Apps Script properties `APP_URL` (public HTTPS) และ `APP_API_KEY`
* add-on ใช้ `localhost` ไม่ได้ — ใช้ tunnel สำหรับทดสอบ API ในเครื่อง
### Could not read your sheet [#could-not-read-your-sheet]
MailG อ่านสเปรดชีตที่ใช้งานไม่ได้
* ตรวจสอบว่าเปิดแท็บชีต (ไม่ใช่แค่ Apps Script editor)
* โหลดสเปรดชีตใหม่ แล้วเปิดกล่องโต้ตอบอีกครั้ง
* ยืนยันว่ามีสิทธิ์แก้ไขไฟล์
### Loading… ไม่เสร็จ [#loading-ไม่เสร็จ]
ปิดกล่องโต้ตอบ รีเฟรช Sheets รอ \~15 วินาทีให้ Extensions โหลด แล้ว **🚀 Start** อีกครั้ง
## ชีตว่าง [#ชีตว่าง]
**No email address found in your sheet**
MailG ต้องมีอย่างน้อยหนึ่งคอลัมน์ที่มีที่อยู่อีเมลที่ถูกต้อง
* เพิ่มอีเมลใต้หัวคอลัมน์ หรือคลิก **Fill with mock data**
* Mock data สร้าง `Email`, `First Name`, `Last Name`, `Company` และมักสร้าง **My First Template**
ดู [ทัวร์ Start dialog](/getting-started/start-dialog)
## แม่แบบ [#แม่แบบ]
* สร้าง: `Creating Template...` → `Template created successfully!` หรือ `Failed to create template! Try again later.`
* อัปเดต: `Updating template...`
* ลบล้มเหลว: `Failed to delete template. Try again later`
ดู [แม่แบบ](/features/templates)
## ปัญหาการส่ง [#ปัญหาการส่ง]
### ปุ่มส่งปิด / Send emails ไม่มีจำนวน [#ปุ่มส่งปิด--send-emails-ไม่มีจำนวน]
* เลือก **Template**
* เลือก **Recipient column** ที่มีอีเมล**เดียว**ที่ถูกต้องต่อเซลล์
* Toast ป้องกันที่อาจเห็น: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### แคมเปญเริ่มไม่ได้ [#แคมเปญเริ่มไม่ได้]
Toast: `Failed to create campaign. Please try again.`
* ลองอีกครั้ง
* ตรวจ **Daily quota** ไม่เป็น 0
* ยืนยันการเชื่อมต่อ API (ดูด้านบน)
### แถวแสดง ⚠️ Failed [#แถวแสดง-️-failed]
แถวนั้นเกิดข้อผิดพลาดการส่ง (ที่อยู่ไม่ถูกต้อง Gmail ปฏิเสธ โควตาชั่วคราว ฯลฯ) แก้ข้อมูลแล้วเริ่มแคมเปญใหม่สำหรับแถวที่เหลือ หรือดู [หยุดแคมเปญ](/features/stopping-a-campaign)
### อีเมลทดสอบล้มเหลว [#อีเมลทดสอบล้มเหลว]
* `Configure your preview first` — เลือกแม่แบบ + ผู้รับให้ตัวอย่างมี To
* `Failed to send test email. Please check your email settings.` — อนุญาต Gmail ใหม่หากจำเป็น แล้วลองอีกครั้ง
## การติดตาม [#การติดตาม]
* การเปิดอ่านต้องให้ผู้รับโหลดรูปภาพระยะไกล
* รัน **🔄 Refresh Tracking** — คาดหวัง `Tracking info synced` หรือ `No active campaigns`
* สถานะ **👀 Opened** ปรากฏเมื่อพิกเซลโหลดเท่านั้น
ดู [การติดตามอีเมล](/features/email-tracking)
## โควตาและ branding [#โควตาและ-branding]
* **N left** ใน sidebar คือ `min(MailG remaining, Gmail remaining)`
* `@gmail.com` ฟรีมักถูก Google จำกัดใกล้ 500/วัน แม้ใช้ Professional
* ลายน้ำยังอยู่หลังชำระเงิน → อีเมล checkout ต้องตรงบัญชี Sheets เปิดกล่องโต้ตอบใหม่
ดู [โควตารายวันและรีวิว](/help/daily-quota-and-reviews) และ [ลบ branding](/features/remove-branding)
## กำหนดเวลาไม่เลื่อน [#กำหนดเวลาไม่เลื่อน]
เวลาน้อยกว่าประมาณ **15 วินาที** ข้างหน้าถือเป็นการส่ง**ทันที** (คอลัมน์ 🚀) ไม่ใช่กำหนดเวลา 🗓️ เลือกเวลาไกลกว่านั้น
## ยังติดอยู่? [#ยังติดอยู่]
FAQ เต็ม: [FAQ](/help/faq) · อีเมล [contact@mailg.io](mailto:contact@mailg.io) · เว็บไซต์ [app.mailg.io/help](https://www.mailg.io/th/help)
# โควตารายวันและรีวิว (/th/help/daily-quota-and-reviews)
Sidebar ของ root แสดงความจุการส่งเมื่อโหลดข้อมูลบัญชีแล้ว
## บล็อก Daily quota [#บล็อก-daily-quota]
UI ตามจริง:
* ป้าย: **Daily quota**
* ที่เหลือ: **N left**
* บรรทัดแผน: **Your plan sends up to TOTAL/day**
**ที่เหลือ** คือค่าน้อยสุดของ:
1. โควตาแผน MailG ที่เหลือสำหรับวัน
2. โควตาส่ง Gmail ที่เหลือสำหรับบัญชี
ดังนั้นคุณอาจถูกจำกัดโดย Gmail แม้ MailG ยังแสดงเหลืออยู่บนกระดาษ ดู [บัญชีและการเรียกเก็บเงิน](/help/account-and-billing) ด้วย
## CTA แผนฟรี [#cta-แผนฟรี]
เมื่อยังไม่ได้สมัคร sidebar อาจแสดง:
* **Leave a 5★ review for +N/day free** (โบนัสเริ่มต้น **+50/day** เมื่อ API ไม่ระบุอย่างอื่น)
* **Or upgrade your plan**
คลิก CTA รีวิวเปิด **Free Quota upgrade**:
* หัวข้อ: **Free Quota upgrade**
* เนื้อหา: ให้รีวิว 5 ดาวเพื่อรับอัปเกรดโควตาฟรี **+N emails/day**
* ปุ่ม: **Not now** | **Leave a 5★ review**
หาก URL รีวิวไม่ได้ตั้งค่า **Leave a 5★ review** จะปิดใช้งาน — ใช้ **Upgrade to Pro** / pricing แทน
## อัปเกรดเป็น Pro [#อัปเกรดเป็น-pro]
ปุ่ม footer (บัญชีฟรี): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
ตรงกับสิ่งที่แผนแบบชำระเงินปลดล็อกในผลิตภัณฑ์ปัจจุบัน
## ที่เกี่ยวข้อง [#ที่เกี่ยวข้อง]
* [ลบ branding](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# บัญชีและการเรียกเก็บเงิน (/th/help/account-and-billing)
การเรียกเก็บเงิน MailG ผูกกับ**อีเมลบัญชี Google** ใน Sheets ชำระเงินด้วยที่อยู่เดียวกันเสมอเพื่อให้โควตาปลดล็อกใน add-on
## แผนและโควตารายวัน [#แผนและโควตารายวัน]
| แผน | โควตารายวัน | หมายเหตุ |
| ------------ | ----------- | -------------------------------------------- |
| Free | 50 | Merge หลัก การติดตามการเปิดอ่าน การกำหนดเวลา |
| Personal | 250 | แผนยอดนิยมสำหรับรายการที่กำลังเติบโต |
| Professional | 1,500 | โควตารายวันสูงสุดแบบรายเดือน |
| Lifetime | 1,500 | ซื้อครั้งเดียว |
ราคาและช่วงเวลาอยู่ที่ [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=th) (EUR และ USD)
สิทธิ์แบบชำระเงินยังปลดล็อก:
* [Send pacing](/features/send-pacing) ที่ไม่ใช่ค่าเริ่มต้น (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
ปริมาณส่งจริงคือ `min(MailG daily quota, Gmail remaining quota)`
## วิธีอัปเกรด [#วิธีอัปเกรด]
1. เปิด [pricing](https://app.mailg.io/pricing?lang=th) (ลิงก์จาก add-on ผ่าน **Upgrade to Pro** ด้วย)
2. เลือกแผนและทำ Stripe Checkout ด้วยอีเมล Google Sheets ของคุณ
3. เปิด MailG ใน Sheets ใหม่เพื่อให้การรีเฟรชบัญชีรับขีดจำกัดใหม่
## ยกเลิกหรืออัปเดตการสมัคร [#ยกเลิกหรืออัปเดตการสมัคร]
คุณยกเลิกหรือเปลี่ยนการสมัครจาก Stripe customer portal ที่ลิงก์ใน flow การสมัคร / pricing
* หากยกเลิกกลางรอบ ฟีเจอร์ Premium ยังใช้ได้จนสิ้นระยะที่ชำระแล้ว
* จะไม่ถูกเรียกเก็บอีกหลังการยกเลิกมีผล
## การคืนเงิน [#การคืนเงิน]
หากยกเลิกการสมัคร Premium ภายใน **30 วัน** หลังซื้อ คุณอาจขอคืนเงินเต็มจำนวนโดยอีเมล [contact@mailg.io](mailto:contact@mailg.io)
## ใบแจ้งหนี้ [#ใบแจ้งหนี้]
Stripe ส่งใบเสร็จทางอีเมลสำหรับการชำระที่สำเร็จ ดาวน์โหลดใบแจ้งหนี้จาก Stripe customer portal ที่ใช้จัดการการสมัครได้ด้วย
## คำถาม FAQ สั้นๆ [#คำถาม-faq-สั้นๆ]
**MailG รวมใน Google Workspace ไหม?**\
ไม่ MailG แยกจาก Google การสมัคร Workspace ไม่รวม MailG
**รับวิธีชำระเงินอะไรบ้าง?**\
บัตรหลัก Google Pay และ Apple Pay ผ่าน Stripe ไม่รองรับ PayPal
**จ่ายแล้วแต่ยังเห็นขีดจำกัดฟรี / ลายน้ำ**\
เกือบทุกครั้งคืออีเมลไม่ตรง ยืนยันอีเมล checkout = อีเมลบัญชี Sheets แล้วเปิด add-on ใหม่ หากยังเป็นอยู่ ติดต่อ support พร้อมอีเมลทั้งสอง
**ทำไม Gmail ฟรีถูกจำกัดประมาณ 500 อีเมลต่อวัน?**\
MailG Professional อนุญาตถึง 1,500 อีเมลต่อวัน แต่ Google เองจำกัดบัญชี `@gmail.com` ฟรีประมาณ 500 ครั้งต่อวัน บัญชี Google Workspace สูงกว่าได้ นี่เป็นขีดจำกัดของ Gmail ไม่ใช่ MailG
# การกำหนดเวลาแคมเปญ (/th/features/campaign-scheduling)
ใช้ **Schedule send** เมื่อต้องการให้ MailG เริ่มภายหลัง ใช้ได้ทั้งแผนฟรีและแบบชำระเงิน
## วิธีกำหนดเวลา [#วิธีกำหนดเวลา]
1. ตั้งค่าแม่แบบและผู้รับให้ปุ่มส่งเปิดใช้งาน
2. เปิดเมนูส่ง (chevron) → **Schedule send**
3. หัวข้อกล่องโต้ตอบ: **Schedule send**
4. คำอธิบาย: `Pick date & time to schedule sending`
5. บรรทัดสรุป: กำหนดเวลาส่ง N อีเมลให้เริ่มที่วันที่/เวลาที่เลือก
6. ใช้ date picker บวก **Hour** / **Minute** (placeholder `Hour`, `Min`)
7. ยืนยันด้วย **Schedule Send** (หรือ **Cancel**)
ค่าเริ่มต้นแนะนำประมาณ **60 นาที** ข้างหน้า ปัดเป็นขั้น **15 นาที** ถัดไป
## ทันที vs กำหนดเวลา [#ทันที-vs-กำหนดเวลา]
เวลาน้อยกว่าประมาณ **15 วินาที** ข้างหน้าถือเป็นการส่ง**ทันที** (หัวคอลัมน์ 🚀) ไม่ใช่กำหนดเวลา 🗓️ เลือกเวลาไกลกว่านั้นหากต้องการส่งแบบเลื่อน
Toast ตรวจสอบ: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`
Toast สำเร็จ: กำหนดเวลาแคมเปญแล้ว N อีเมลจะเริ่มที่เวลาที่เลือก
## คอลัมน์ชีต [#คอลัมน์ชีต]
แคมเปญที่กำหนดเวลาสร้างหัวคอลัมน์เช่น:
```text
🗓️ Template name (yyyy/MM/dd)
```
การส่งทันทีใช้ 🚀 แทน 🗓️
แถวเริ่มเป็น **🗓️ Scheduled** แล้วเปลี่ยนเป็น **⏳ Sending…** เมื่อคิวทำงาน
## หลังกำหนดเวลา [#หลังกำหนดเวลา]
* ให้สเปรดชีตเข้าถึงได้โดยบัญชี Google ที่เป็นเจ้าของ add-on
* การติดตามและ pacing ยังใช้เมื่อเริ่มส่ง
* ไม่มี UI **Manage Schedule** — ดู [หยุดแคมเปญ](/features/stopping-a-campaign)
## ที่เกี่ยวข้อง [#ที่เกี่ยวข้อง]
* [ดูตัวอย่างและทดสอบ](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# ผู้รับหลายคน (/th/features/multiple-recipients)
คุณสามารถเพิ่มผู้รับสำเนาต่อแถวด้วยคอลัมน์ชีตเฉพาะ
## คอลัมน์ผู้รับ (To) [#คอลัมน์ผู้รับ-to]
เลือก **Recipient column** ใน sidebar
สำหรับการนับปุ่มส่งและการตรวจสอบคอลัมน์ MailG ถือว่าเซลล์ถูกต้องเมื่อเป็น**อีเมลเดียว** ใช้ที่อยู่ To หลักหนึ่งที่อยู่ต่อแถว
## คอลัมน์ CC และ BCC [#คอลัมน์-cc-และ-bcc]
1. เพิ่มคอลัมน์ในชีต (เช่น `CC` และ `BCC`)
2. ใส่อีเมล (หรือรายการที่ Gmail ยอมรับ) ในเซลล์
3. เปิด **More options** แล้วแมป **CC** / **BCC**
4. เมื่อส่ง ค่าเหล่านั้นถูกส่งไปยัง Gmail
บานหน้าต่างตัวอย่างแสดง **From**, **To**, **Subject** และ body เท่านั้น **ไม่**แสดงบรรทัด CC/BCC แม้จะแมปแล้ว ยืนยันด้วย **Send me a test email** หากต้องตรวจสอบการส่ง CC/BCC
## โควตา: MailG vs Gmail [#โควตา-mailg-vs-gmail]
* **โควตารายวัน MailG** นับ**แถวแคมเปญ**ที่ประมวลผล
* **ขีดจำกัดการส่ง Gmail** นับ**ผู้รับ** (ที่อยู่ To + CC + BCC ที่ Gmail ยอมรับในการส่งนั้น)
คุณยังอาจชนเพดาน Gmail ขณะที่โควตา MailG ยังเหลือ
## เคล็ดลับ [#เคล็ดลับ]
* ใช้ **BCC** เมื่อผู้รับไม่ควรเห็นกัน
* ปล่อย CC/BCC ไม่แมปเมื่อไม่ใช้
* ตรวจสอบที่อยู่ก่อนส่งจำนวนมาก
# Attachments (/th/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# ภาพรวมฟีเจอร์ (/th/features/features-overview)
สิ่งที่ add-on รองรับในปัจจุบัน:
| ฟีเจอร์ | เอกสาร |
| ------------------------------------ | ---------------------------------------------------- |
| Start dialog / ชีตว่าง / mock data | [ทัวร์ Start dialog](/getting-started/start-dialog) |
| แม่แบบ (สร้าง / จัดการ / แก้ไข / ลบ) | [แม่แบบ](/features/templates) |
| Merge tag ใน **body** | [Merge tag](/features/merge-tags) |
| แถบเครื่องมือ rich text | [อีเมล rich text](/features/rich-text-emails) |
| ลิงก์ (ไม่ใช่การฝังรูปภาพ) | [รูปภาพ](/features/images) |
| ดูตัวอย่าง + อีเมลทดสอบ | [ดูตัวอย่างและทดสอบ](/features/preview-and-test) |
| กำหนดเวลาส่ง | [การกำหนดเวลาแคมเปญ](/features/campaign-scheduling) |
| Send pacing (แบบชำระเงิน) | [Send pacing](/features/send-pacing) |
| คอลัมน์ CC / BCC | [ผู้รับหลายคน](/features/multiple-recipients) |
| Track emails | [การติดตามอีเมล](/features/email-tracking) |
| Sender name และ reply-to | [ปรับแต่งผู้ส่ง](/features/customized-sender) |
| Remove branding (แบบชำระเงิน) | [ลบ branding](/features/remove-branding) |
| หยุดแถวที่เหลือ | [หยุดแคมเปญ](/features/stopping-a-campaign) |
| โควตารายวัน + โบนัสรีวิว | [โควตารายวันและรีวิว](/help/daily-quota-and-reviews) |
## ฟรี vs แบบชำระเงิน [#ฟรี-vs-แบบชำระเงิน]
แบบชำระเงินปลดล็อก:
* [Send pacing](/features/send-pacing) ที่ไม่ใช่ค่าเริ่มต้น
* [Remove branding](/features/remove-branding)
* [โควตารายวันที่สูงขึ้น](/help/account-and-billing)
**Schedule send**, **Track emails** และเครื่องมือแม่แบบใช้งานได้โดยไม่ต้องอัปเกรดแบบชำระเงิน
## ช่องว่างที่ทราบ (ตรงไปตรงมา) [#ช่องว่างที่ทราบ-ตรงไปตรงมา]
| หัวข้อ | สถานะในผลิตภัณฑ์ |
| ------------------------ | ---------------------------------- |
| Merge tag ในหัวเรื่อง | ไม่ถูกใช้เมื่อส่ง — เฉพาะ body |
| คอลัมน์ Attachments | มีเฉพาะ UI — ไม่แนบเมื่อส่ง |
| การฝังรูปภาพ | ไม่มีตัวควบคุมใน editor — ใช้ลิงก์ |
| บรรทัด CC/BCC ในตัวอย่าง | ไม่แสดงใน UI ตัวอย่าง |
| Manage Schedule / Pause | ยังไม่มี — ใช้วิธีแก้ด้วยสถานะ |
## จะมาในอนาคต [#จะมาในอนาคต]
ลิงก์ยกเลิกการสมัคร การติดตามคลิก ที่นั่งทีมแบบแชร์ และ UI จัดการแคมเปญเฉพาะเมื่อมีการเปิดตัว
# การติดตามอีเมล (/th/features/email-tracking)
MailG สามารถบันทึกการเปิดอ่านด้วยพิกเซลเล็กๆ ที่มองไม่เห็น
## เปิดการติดตาม [#เปิดการติดตาม]
ใน sidebar เปิด **Track emails** ไว้ (ค่าเริ่มต้นเปิดสำหรับงานใหม่)
Tooltip: `Track emails opened with a tiny pixel`
ไอคอนความช่วยเหลือเปิด **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
ปุ่ม: **Got it**
## สถานะชีต [#สถานะชีต]
| สถานะ | ความหมาย |
| ------------- | ----------------------------- |
| 🗓️ Scheduled | รอเวลาเริ่มที่กำหนด |
| ⏳ Sending… | กำลังประมวลผล |
| ✉️ Sent | ส่งไปยัง Gmail สำหรับแถวนั้น |
| ⚠️ Failed | ข้อผิดพลาดการส่งสำหรับแถวนั้น |
| 👀 Opened | โหลดพิกเซลเปิดอ่านแล้ว |
หัวคอลัมน์แคมเปญมีลักษณะ `🚀 Template name (yyyy/MM/dd)` หรือ `🗓️ …` เมื่อกำหนดเวลา
## รีเฟรชการติดตาม [#รีเฟรชการติดตาม]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
การแจ้งเตือน Apps Script:
* `Tracking info synced`
* `No active campaigns`
## ข้อจำกัด [#ข้อจำกัด]
* ไคลเอนต์ต้องโหลดรูปภาพระยะไกล
* พร็อกซีความเป็นส่วนตัวอาจซ่อนการเปิดอ่าน
* เปิดอ่านเท่านั้น — ไม่ติดตามคลิกลิงก์
## ที่เกี่ยวข้อง [#ที่เกี่ยวข้อง]
* [การกำหนดเวลาแคมเปญ](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Merge tag (/th/features/merge-tags)
Merge tag ทำให้ผู้รับแต่ละคนได้ **body** ที่ปรับแต่งแล้ว แท็กคือ**หัวคอลัมน์ที่ตรงกันทุกประการ** ห่อด้วยวงเล็บปีกกาคู่
## ไวยากรณ์ [#ไวยากรณ์]
หากชีตมีคอลัมน์ชื่อ `First Name` ให้ใช้:
```text
{{First Name}}
```
ตัวอย่าง body:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Merge tag ใช้ได้ที่ไหนในปัจจุบัน [#merge-tag-ใช้ได้ที่ไหนในปัจจุบัน]
| ฟิลด์ | Merge เมื่อส่ง? |
| --------------- | ------------------------------------------- |
| Email body | **ใช่** — ตัวแปรถูกแทรกต่อแถว |
| Email subject | **ไม่** — หัวเรื่องถูกส่งตามที่เก็บในแม่แบบ |
| Preview body | **ใช่** — สำหรับแถวที่ใช้งาน |
| Preview subject | **ไม่** — แสดงหัวเรื่องแม่แบบดิบ |
ใส่การปรับแต่งใน body จนกว่าจะมี merge ในหัวเรื่อง
## การแทรกแท็ก [#การแทรกแท็ก]
ในแถบเครื่องมือ editor เปิด **Merge Tag** จะแสดงรายการหัวคอลัมน์จากชีตที่ใช้งาน สถานะว่าง: `No sheet columns found`
ข้อความที่แทรกใช้วงเล็บปีกกาคู่รอบชื่อคอลัมน์
## หลักการใช้งาน [#หลักการใช้งาน]
* หัวคอลัมน์ต่างตัวพิมพ์ใหญ่-เล็ก (`Name` ≠ `name`)
* เซลล์ว่างแทรกเป็นสตริงว่าง
* ใช้แท็กเดียวกันซ้ำใน body ได้หลายครั้ง
* ผู้รับ / CC / BCC เลือกภายใต้ **More options** ไม่ใช่ผ่าน merge tag
## ถัดไป [#ถัดไป]
ดู [อีเมล rich text](/features/rich-text-emails) และ [ดูตัวอย่างและทดสอบ](/features/preview-and-test)
# อีเมล rich text (/th/features/rich-text-emails)
แม่แบบ MailG ใช้ rich-text editor ของ TipTap HTML ที่สร้างคือสิ่งที่ Gmail ส่งออกไป
Placeholder body: `Write your email…`
## รายการแถบเครื่องมือ (ตาม UI) [#รายการแถบเครื่องมือ-ตาม-ui]
| กลุ่ม | ตัวควบคุม |
| ----------- | --------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (ค่าที่ตั้งไว้ในแถบเครื่องมือ) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | สีที่ตั้งไว้ + color picker ของระบบ + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — placeholder ฟิลด์ URL `https://example.com` แล้ว **Apply** (และยกเลิกลิงก์) |
| History | **Undo**, **Redo** |
## ไม่มีใน editor [#ไม่มีใน-editor]
ฟีเจอร์ TipTap เหล่านี้ถูกปิดใช้งาน / ไม่มี:
* Headings, code, code block, blockquote, horizontal rule
* การแทรกรูปภาพ / Drive media picker — ดู [รูปภาพ](/features/images)
## ไฮเปอร์ลิงก์ [#ไฮเปอร์ลิงก์]
ใช้ **Insert link** สำหรับ URL และข้อความที่มองเห็น ใช้ข้อความลิงก์ที่ชัดเจนแทน URL ดิบ
## เคล็ดลับ [#เคล็ดลับ]
* ใช้ **Merge Tag** แทนการพิมพ์วงเล็บปีกกาด้วยมือ
* ดูตัวอย่างหลายแถวก่อนส่ง — ดู [ดูตัวอย่างและทดสอบ](/features/preview-and-test)
* หลีกเลี่ยง markup จาก Word/Docs ที่วางมาขนาดใหญ่ จัดรูปแบบใหม่ใน MailG เพื่อ HTML ที่สะอาดกว่า
# ลบ branding MailG (/th/features/remove-branding)
แคมเปญฟรีอาจมีลายน้ำ MailG เล็กๆ ใน footer อีเมล ผู้สมัครแบบชำระเงินปิดได้
## วิธีลบ branding [#วิธีลบ-branding]
1. ยืนยันว่ามีแผนแบบชำระเงินที่ใช้งานอยู่ (Personal, Professional หรือ Lifetime)
2. เปิด sidebar แคมเปญ
3. เปิด **Remove branding**
4. ดูตัวอย่างแถวเพื่อยืนยันว่าลายน้ำหายไป แล้วส่ง
หาก branding ยังปรากฏหลังชำระเงิน:
* ตรวจสอบว่า checkout ใช้**อีเมลเดียวกัน**กับบัญชี Google Sheets
* เปิด add-on ใหม่เพื่อรีเฟรชสิทธิ์จาก API
* ติดต่อ [contact@mailg.io](mailto:contact@mailg.io) พร้อมอีเมลบัญชี Google
ดู [บัญชีและการเรียกเก็บเงิน](/help/account-and-billing)
# รูปภาพ (/th/features/images)
Editor ของ MailG **ไม่มีปุ่มแทรกรูปภาพ** และไม่มี Google Drive media picker ส่วนขยาย Image ของ TipTap ไม่ได้เปิดใช้งาน
## สิ่งที่ทำได้ในปัจจุบัน [#สิ่งที่ทำได้ในปัจจุบัน]
ใช้ **Insert link** ในแถบเครื่องมือ:
1. โฮสต์รูปภาพ (หรือไฟล์) ที่ URL สาธารณะ หรือแชร์ลิงก์ Drive
2. เลือกข้อความ (หรือวางเคอร์เซอร์) → **Insert link**
3. วาง URL (placeholder `https://example.com`) → **Apply**
ผู้รับเปิดลิงก์เพื่อดูรูปภาพหรือไฟล์ editor ไม่ฝังแท็ก `![]()
` ให้คุณ
## เคล็ดลับ [#เคล็ดลับ]
* ใช้ไฟล์ขนาดเล็กและข้อความลิงก์ที่ชัดเจน ("View screenshot")
* ลิงก์ที่ต้องลงชื่อเข้าใช้จะล้มเหลวสำหรับผู้รับ
* ยืนยันด้วย **Send me a test email**
## จะมาในอนาคต [#จะมาในอนาคต]
การฝังรูปภาพ / Drive picker แบบเต็มรูปแบบอาจมีในอนาคต จนกว่านั้น ไฮเปอร์ลิงก์คือวิธีที่รองรับ
# แม่แบบ (/th/features/templates)
แม่แบบเก็บหัวเรื่องและ body แบบ rich text ที่คุณใช้ซ้ำในแคมเปญต่างๆ บันทึกไว้ที่ MailG API สำหรับบัญชี Google ของคุณ
## สร้างแม่แบบ [#สร้างแม่แบบ]
1. บนหน้าจอ root คลิก **New Template**
2. กรอก:
* **Template Name**
* **Email Subject**
* Body (rich editor — ดู [อีเมล rich text](/features/rich-text-emails))
3. คลิก **Save Template** (แสดง **Saving...** ขณะทำงาน)
Toast:
* กำลังโหลด: `Creating Template...`
* สำเร็จ: `Template created successfully!`
* ข้อผิดพลาด: `Failed to create template! Try again later.`
แม่แบบสาธิตจาก **Fill with mock data**: ชื่อ **My First Template**, หัวเรื่อง `I found a mail merge tool for Gmail`
## จัดการแม่แบบ [#จัดการแม่แบบ]
เปิดไอคอนแม่แบบข้าง select แม่แบบ (tooltip **Manage templates**)
คอลัมน์ตาราง:
| คอลัมน์ | เนื้อหา |
| ----------------- | --------------- |
| **Name** | ชื่อแม่แบบ |
| **Email Subject** | บรรทัดหัวเรื่อง |
| **Created At** | วันที่สร้าง |
| **Actions** | เมนูแถว |
เมนูแถว: **Edit** | **Delete**
Footer: **Back**
Toast ลบ: กำลังลบแม่แบบ NAME → ลบแม่แบบ NAME สำเร็จ (หรือข้อความล้มเหลว)
## แก้ไขแม่แบบ [#แก้ไขแม่แบบ]
เปิด **Edit** จากหน้าจัดการ หรือคลิก **Edit template** ในแถบเครื่องมือตัวอย่าง
ฟิลด์เดียวกับการสร้าง **Save Template** อัปเดตแม่แบบ
ขั้นตอนอัปเดตแสดง toast กำลังโหลด (`Updating template...`) อยู่บนฟอร์มจนเสร็จ แล้วใช้ **Cancel** หรือ **Back** หากไม่ถูกพากลับอัตโนมัติ
## หัวเรื่อง vs body [#หัวเรื่อง-vs-body]
* **Body** รองรับ [merge tag](/features/merge-tags) — ถูกแทรกต่อแถวเมื่อส่ง
* **Email Subject** ถูกส่งตามที่เก็บไว้ในปัจจุบัน (merge tag ในหัวเรื่องยัง**ไม่**ถูกแทนที่) ใส่การปรับแต่งใน body หรือใช้หัวเรื่องคงที่
## ที่เกี่ยวข้อง [#ที่เกี่ยวข้อง]
* [ดูตัวอย่างและทดสอบ](/features/preview-and-test)
* [ทัวร์ Start dialog](/getting-started/start-dialog)
# ดูตัวอย่างและทดสอบ (/th/features/preview-and-test)
บานหน้าต่างตัวอย่าง (ด้านขวาของกล่องโต้ตอบ root) แสดงว่าข้อความจะเป็นอย่างไรสำหรับแถวชีตที่ใช้งาน
## สิ่งที่ตัวอย่างแสดง [#สิ่งที่ตัวอย่างแสดง]
| ฟิลด์ | เนื้อหา |
| ------------ | ------------------------------------------------------------------------------- |
| **From:** | อีเมลบัญชี Google ที่ลงชื่อเข้าใช้ |
| **To:** | ค่าจาก **Recipient column** สำหรับแถวที่ใช้งาน หรือ `Select a recipient column` |
| **Subject:** | หัวเรื่องแม่แบบตามที่เก็บ (ไม่ merge แทนที่) |
| Body | Body แม่แบบพร้อม merge tag ที่ใช้กับแถวนั้น |
หาก **Remove branding** ปิด ตัวอย่างจะรวม footer ลายน้ำ MailG (`made and sent with` / **MailG** / `Email Marketing from Gmail`)
## สิ่งที่ไม่แสดง [#สิ่งที่ไม่แสดง]
* บรรทัด **CC** / **BCC** ไม่ถูกแสดงใน UI ตัวอย่าง (แม้จะแมปภายใต้ **More options**) ยังถูกใช้เมื่อส่ง
* ค่าคอลัมน์ Attachments ไม่แสดงในตัวอย่าง
## เลื่อนดูแถว [#เลื่อนดูแถว]
แถบเครื่องมือตัวอย่าง:
* **Edit template** — เปิดหน้าจออัปเดตแม่แบบ
* **Previous recipient** / **Next recipient** — เลื่อนระหว่างแถวข้อมูล (tooltip อาจมีหมายเลขแถวชีต หัวคอลัมน์คือแถว 1 ผู้ติดต่อคนแรกคือแถว 2)
## ส่งอีเมลทดสอบให้ฉัน [#ส่งอีเมลทดสอบให้ฉัน]
1. ตั้งค่าแม่แบบ + คอลัมน์ผู้รับให้ตัวอย่างถูกต้อง
2. เปิดเมนูส่ง (chevron) → **Send me a test email**
3. Busy overlay: `Sending test email…`
4. Toast สำเร็จ: `Test email sent successfully. Check your inbox.`
5. Toast ล้มเหลว: `Failed to send test email. Please check your email settings.`
6. ป้องกันหากตัวอย่างไม่สมบูรณ์: `Configure your preview first`
อีเมลทดสอบไปยังกล่องจดหมายบัญชี Google **ของคุณ** ใช้ body ที่ merge แล้วจากแถวตัวอย่างที่ใช้งาน
## เคล็ดลับ [#เคล็ดลับ]
* เลื่อนดูหลายแถวด้วยลูกศรก่อนส่งเต็มรูปแบบ
* ยืนยัน branding / ไม่มี branding ในตัวอย่าง
* ทดสอบเสมอก่อน **Schedule send** หรือ **Send N email(s)** จำนวนมาก
## ที่เกี่ยวข้อง [#ที่เกี่ยวข้อง]
* [Merge tag](/features/merge-tags)
* [บทช่วยสอน mail merge](/getting-started/mail-merge-tutorial)
# จังหวะการส่ง (/th/features/send-pacing)
Send pacing เพิ่มความหน่วงระหว่างข้อความเพื่อไม่ให้แคมเปญขนาดใหญ่ออกจากบัญชีเป็นการระเบิดครั้งเดียว
**Steady pace** และ **Jittered gaps** ต้องมีการสมัคร MailG แบบชำระเงินที่ใช้งานอยู่ บัญชีฟรีใช้ **Burst send** เท่านั้น
## ตั้งค่าที่ไหน [#ตั้งค่าที่ไหน]
เปิดเฟืองที่ footer (tooltip **Send pacing**) หัวข้อหน้าจอ: **Send pacing**
ภายใต้ **Dispatch mode** เลือกวิธีเว้นระยะอีเมล **Gap between emails** ตั้งเป็น**วินาที** (0–60) บัญชีฟรีเห็น **Pro features** และข้อความล็อก: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
ค่าเริ่มต้นสำหรับงานใหม่: **Burst send**, gap **10s** (gap ถูกละเว้นจนกว่าจะออกจาก burst)
## โหมด [#โหมด]
| โหมด (ป้าย UI) | พฤติกรรม |
| ---------------------------- | -------------------------------------------- |
| **Burst send** (ค่าเริ่มต้น) | ส่งเร็วที่สุดตามโควตาที่อนุญาต |
| **Steady pace** | รอช่องว่างคงที่ระหว่างอีเมลแต่ละฉบับ |
| **Jittered gaps** | รอช่องว่างสุ่มระหว่าง 0 ถึงค่าสูงสุดที่เลือก |
## ทำไมต้องใช้ pacing [#ทำไมต้องใช้-pacing]
* ลดโอกาสดูเหมือนการระเบิดทันทีต่อผู้ให้บริการกล่องจดหมาย
* กระจายรายการยาวในช่วงส่งที่เงียบกว่า
* อยู่ในโซนที่ Gmail สบายใจสำหรับประเภทบัญชีของคุณ
## หมายเหตุ [#หมายเหตุ]
* Pacing เป็นการตั้งค่าแคมเปญที่เก็บกับงาน — การส่งใหม่ใช้การตั้งค่าปัจจุบัน
* ช่องว่างยาวในรายการใหญ่เพิ่มระยะเวลาแคมเปญรวมอย่างมาก
* ความเร็วจริงยังถูกจำกัดโดยโควตารายวัน MailG **และ** โควตาส่งที่เหลือของ Gmail
* เครื่องมือคู่แข่งบางตัวแสดงความหน่วงเป็นนาที — MailG ใช้**วินาที**
## ที่เกี่ยวข้อง [#ที่เกี่ยวข้อง]
* [หยุดแคมเปญ](/features/stopping-a-campaign) หากตั้งช่องว่างสูงเกินไประหว่างทำงาน
* [บัญชีและการเรียกเก็บเงิน](/help/account-and-billing)
# หยุดแคมเปญ (/th/features/stopping-a-campaign)
MailG ยังไม่มีหน้าจอ **Manage Schedule**, **Abort** หรือ **Pause** เฉพาะเหมือนคู่แข่งบางราย คุณยังหยุดแถว**ที่เหลือ**จากการส่งได้
## การส่งตัดสินว่าจะประมวลผลอะไร [#การส่งตัดสินว่าจะประมวลผลอะไร]
ลูปส่งประมวลผลเฉพาะแถวที่สถานะคอลัมน์แคมเปญยังส่งได้:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
แถวที่ถูกทำเครื่องหมาย **✉️ Sent**, **⚠️ Failed** หรือ **👀 Opened** แล้วจะถูกข้าม
## หยุดแถวที่เหลือ (วิธีแก้ที่ตรงไปตรงมา) [#หยุดแถวที่เหลือ-วิธีแก้ที่ตรงไปตรงมา]
ดำเนินการเร็วในแคมเปญขนาดใหญ่:
1. เปิดสเปรดชีต
2. ในคอลัมน์สถานะแคมเปญ ล้างหรือเปลี่ยนสถานะในแถวที่**ต้องไม่**ส่ง (เช่น ลบค่าเซลล์ หรือตั้งป้ายที่ส่งไม่ได้ เช่น `Stopped`)
3. ปล่อยแถว **✉️ Sent** ที่ส่งแล้วไว้ — ข้อความเหล่านั้นออกไปแล้ว
แถวที่คุณล้าง/เปลี่ยนจะไม่ตรงกับสถานะที่ส่งได้อีก คิวจึงข้ามในรอบถัดไป
ข้อความ Gmail ที่ออกจากบัญชีแล้ว MailG เรียกคืนไม่ได้ การหยุดปกป้องเฉพาะแถวที่ยังไม่ถูกประมวลผล
## แคมเปญที่กำหนดเวลาที่ยังไม่เริ่ม [#แคมเปญที่กำหนดเวลาที่ยังไม่เริ่ม]
หากทุกแถวยังเป็น **🗓️ Scheduled** และเวลาเริ่มยังไม่ถึง การล้างสถานะเหล่านั้น (หรือคอลัมน์แคมเปญ) ป้องกันคิวหยิบขึ้นเมื่อถึงเวลา
หากไม่แน่ใจ ติดต่อ [contact@mailg.io](mailto:contact@mailg.io) พร้อม URL สเปรดชีตและรายละเอียดแคมเปญ
## ที่เกี่ยวข้อง [#ที่เกี่ยวข้อง]
* [การกำหนดเวลาแคมเปญ](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# ปรับแต่งผู้ส่ง (/th/features/customized-sender)
โดยค่าเริ่มต้น Gmail ส่งจากบัญชี Google ที่อนุญาต MailG คุณยังปรับชื่อที่แสดงและที่อยู่ตอบกลับได้
## ชื่อผู้ส่ง [#ชื่อผู้ส่ง]
1. เปิด **More options** ใน sidebar แคมเปญ
2. ตั้ง **Sender name** (placeholder `John Doe (Optional)`)
3. ผู้รับเห็นชื่อที่แสดงนั้นในกล่องจดหมาย (ขึ้นกับกฎการแสดงผลปกติของ Gmail)
## ที่อยู่สำหรับตอบกลับ [#ที่อยู่สำหรับตอบกลับ]
ตั้ง **Reply to address** (placeholder `john@doe.com (Optional)`) หากการตอบกลับควรไปที่อื่นนอกจากบัญชีที่ส่ง
## หมายเหตุ [#หมายเหตุ]
* ที่อยู่ From โดยพื้นฐานยังเป็นบัญชี Gmail ที่อนุญาต — คุณไม่สามารถปลอมกล่องจดหมายอื่น
* ที่อยู่ reply-to ไม่ถูกต้องอาจทำให้ส่งหรือตอบกลับมีปัญหา — ใช้กล่องจดหมายที่คุณควบคุม
* ตัวอย่างแสดง **From:** เป็นอีเมลที่ลงชื่อเข้าใช้ ยืนยัน reply-to ด้วย **Send me a test email**
* ดู [ดูตัวอย่างและทดสอบ](/features/preview-and-test)
# ทัวร์ Start dialog (/th/getting-started/start-dialog)
เปิด add-on ด้วย **Extensions → MailG for Gmail → 🚀 Start** กล่องโต้ตอบขนาด 900×600 ชื่อ **MailG for Gmail** จะเปิดขึ้น
## หน้าจอ [#หน้าจอ]
| หน้าจอ | วิธีเข้าถึง | วัตถุประสงค์ |
| ------------------ | ---------------------------------------------- | ----------------------------------- |
| Root (composer) | ค่าเริ่มต้นหลังโหลด | เลือกแม่แบบ + ผู้รับ ดูตัวอย่าง ส่ง |
| Create template | **New Template** | ชื่อ หัวเรื่อง body |
| Manage templates | ไอคอนแม่แบบ (tooltip **Manage templates**) | รายการ แก้ไข ลบ |
| Update template | **Edit template** หรือ **Edit** ในแถว | แก้ไขแม่แบบที่มีอยู่ |
| Settings | ไอคอนเฟืองที่ footer (tooltip **Send pacing**) | โหมด dispatch + ช่องว่าง |
| Empty sheet | ไม่มีคอลัมน์อีเมลที่ถูกต้อง | แจ้งให้เพิ่มผู้ติดต่อหรือ mock data |
| API / sheet errors | โหลดล้มเหลว | คำแนะนำการลองใหม่ |
## เลย์เอาต์ Root [#เลย์เอาต์-root]
สามโซน:
1. **Sidebar** (ซ้าย) — แม่แบบ คอลัมน์ผู้รับ **More options** การติดตาม branding โควตา
2. **Preview** (ขวา) — From / To / Subject / body การนำทางแถว **Edit template**
3. **Footer** — ปุ่มส่ง เมนูส่ง **Upgrade to Pro** (ฟรี) การตั้งค่า ความช่วยเหลือ
## ตัวควบคุม Sidebar (ป้ายกำกับตาม UI) [#ตัวควบคุม-sidebar-ป้ายกำกับตาม-ui]
* **New Template**
* **Template** (select) — placeholder `Select` หรือ `No templates found`
* **Recipient column** — ตัวเลือกเช่น `A - Email`; ว่าง: `No valid email columns found.`
* **More options** — ขยาย **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (เปิดเป็นค่าเริ่มต้น)
* **Remove branding** (แบบชำระเงิน)
* **Daily quota** — จำนวนที่เหลือเป็น "N left" และบรรทัดแผน "Your plan sends up to TOTAL/day"
บัญชีฟรียังเห็น **Leave a 5★ review for +N/day free** และ **Or upgrade your plan** ดู [โควตารายวันและรีวิว](/help/daily-quota-and-reviews)
## ตัวควบคุมส่งที่ Footer [#ตัวควบคุมส่งที่-footer]
| ตัวควบคุม | ป้ายกำกับ |
| ------------- | ------------------------------------------------------------------------------------- |
| ปุ่มหลัก | **Send N email(s)** (หรือ **Send emails** เมื่อจำนวนเป็น 0) |
| เมนูส่ง | **Send me a test email** |
| เมนูส่ง | **Schedule send** |
| Upgrade (ฟรี) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| เฟือง | tooltip **Send pacing** |
| ความช่วยเหลือ | tooltip **Help** — เปิด checklist ในกล่องโต้ตอบ |
### Checklist Need help? [#checklist-need-help]
1. เลือกแม่แบบและคอลัมน์ผู้รับ
2. ดูตัวอย่างแต่ละแถวด้วยลูกศร
3. ส่งอีเมลทดสอบให้ตัวเองก่อน
4. คลิก Send เพื่อ merge จากชีตของคุณ
ปุ่ม: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (ถ้ามี) | **Close**
## ชีตว่าง [#ชีตว่าง]
หาก MailG ไม่พบคอลัมน์อีเมลที่ถูกต้อง:
* หัวข้อ: **No email address found in your sheet**
* การดำเนินการ: **Close** | **Fill with mock data**
Mock data จะสร้างหัวคอลัมน์ `Email`, `First Name`, `Last Name`, `Company` และอาจสร้าง **My First Template**
## หน้าจอข้อผิดพลาด [#หน้าจอข้อผิดพลาด]
| หัวข้อ | เมื่อ |
| --------------------------------- | ---------------------- |
| **Could not reach the MailG API** | API / เครือข่ายล้มเหลว |
| **Could not read your sheet** | อ่านชีตล้มเหลว |
## ถัดไป [#ถัดไป]
# การติดตั้ง (/th/getting-started/installation)
สองขั้นตอน: ติดตั้ง add-on แล้วเปิดจาก Sheets
## ติดตั้ง MailG [#ติดตั้ง-mailg]
1. เปิด [รายการ MailG บน Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg)
2. คลิก **Install**
3. เลือกบัญชี Google ที่จะเป็นเจ้าของการติดตั้ง
4. ตรวจสอบสิทธิ์การเข้าถึงแล้วคลิก **Allow**
การติดตั้งมักเสร็จภายใน 15 วินาที คุณควรเห็นข้อความยืนยันว่าติดตั้ง add-on แล้ว
หากรายการ Marketplace ยังไม่เปิดในภูมิภาคของคุณ ให้ใช้ปุ่มติดตั้งบน [www.mailg.io](https://www.mailg.io) หรือติดต่อ [contact@mailg.io](mailto:contact@mailg.io)
## เปิด MailG ใน Google Sheets [#เปิด-mailg-ใน-google-sheets]
1. เปิด [Google Sheets](https://sheets.google.com) (รีเฟรชหากเปิด Sheets อยู่แล้ว)
2. รอสักครู่ให้ Extensions โหลด (มักใช้เวลา \~10–15 วินาที)
3. ไปที่ **Extensions → MailG for Gmail → 🚀 Start**
ภายหลังคุณสามารถรัน **Extensions → MailG for Gmail → 🔄 Refresh Tracking** เพื่อซิงก์สถานะการเปิดอ่านโดยไม่ต้องเปิดกล่องโต้ตอบเต็มรูปแบบ
## ปัญหาการติดตั้ง [#ปัญหาการติดตั้ง]
สิ่งเหล่านี้เป็นข้อจำกัดทั่วไปของ Google Workspace ไม่ใช่บั๊กของ MailG:
### ไม่เห็นป๊อปอัป "installed successfully" [#ไม่เห็นป๊อปอัป-installed-successfully]
มักเกิดเมื่อลงชื่อเข้าใช้หลายบัญชี Google และการติดตั้งไม่ได้ใช้บัญชีที่คุณคาดไว้
**วิธีแก้:** เปิดหน้าต่าง private/incognito ลงชื่อเข้าใช้ด้วยบัญชีเป้าหมายเพียงบัญชีเดียว แล้วติดตั้งอีกครั้งจาก Marketplace
### MailG ไม่ปรากฏภายใต้ Extensions [#mailg-ไม่ปรากฏภายใต้-extensions]
1. รีเฟรชสเปรดชีต
2. รอประมาณ 10–15 วินาทีให้ add-on โหลด
3. ยืนยันว่าคุณใช้บัญชี Google เดียวกับที่ติดตั้ง MailG
4. ลองสเปรดชีตอื่นหรือล้างแคชเบราว์เซอร์หากยังไม่เห็น
## การ deploy แบบ self-hosted / กำหนดเอง [#การ-deploy-แบบ-self-hosted--กำหนดเอง]
การติดตั้งจาก Marketplace ตั้งค่าไว้ล่วงหน้าแล้ว หากคุณ deploy MailG เอง ให้ตั้งค่า Apps Script script properties:
| Property | Value |
| ------------- | ------------------------------ |
| `APP_URL` | Public HTTPS URL ของ MailG API |
| `APP_API_KEY` | คีย์เดียวกับเซิร์ฟเวอร์ API |
add-on ไม่สามารถเข้าถึง `localhost` จากเซิร์ฟเวอร์ของ Google — ใช้ tunnel (Cloudflare Tunnel, ngrok ฯลฯ) สำหรับทดสอบในเครื่อง
## ถัดไป [#ถัดไป]
ไปต่อที่ [บทช่วยสอน mail merge](/getting-started/mail-merge-tutorial)
# บทช่วยสอน mail merge (/th/getting-started/mail-merge-tutorial)
บทช่วยสอนนี้สอดคล้องกับ start dialog ของ **MailG for Gmail**
## 1. เปิด MailG [#1-เปิด-mailg]
**Extensions → MailG for Gmail → 🚀 Start**
หากคุณเห็น **No email address found in your sheet** ให้เพิ่มอีเมลจริงหรือคลิก **Fill with mock data** (สร้างแถวตัวอย่างและมักสร้าง **My First Template**) ดู [ทัวร์ Start dialog](/getting-started/start-dialog)
## 2. สร้างหรือเลือกแม่แบบ [#2-สร้างหรือเลือกแม่แบบ]
1. คลิก **New Template** (หรือเลือกแม่แบบที่มีอยู่ภายใต้ **Template**)
2. ตั้ง **Template Name** และ **Email Subject** (หัวเรื่องยัง**ไม่**ถูก merge แทนที่ในปัจจุบัน)
3. เขียน body และแทรก [merge tag](/features/merge-tags) ผ่าน **Merge Tag**
4. **Save Template**
ตัวอย่าง body:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. ตั้งค่าแคมเปญ [#3-ตั้งค่าแคมเปญ]
ใน sidebar:
1. เลือก **Recipient column** (เซลล์ต้องเป็นอีเมลเดียวที่ถูกต้องเพื่อให้ UI นับได้)
2. เปิด **More options** สำหรับ **CC**, **BCC**, **Sender name**, **Reply to address**
3. เปิด **Track emails** ไว้ (ค่าเริ่มต้น) หากต้องการสถานะการเปิดอ่านในชีต
4. ในแผนแบบชำระเงิน เปิด **Remove branding**
**Attachments** ปรากฏภายใต้ **More options** แต่ไฟล์ยังไม่ถูกแนบเมื่อส่ง ให้ใส่ลิงก์ไปยัง Drive หรือ URL ใน body แทน
## 4. ดูตัวอย่างและทดสอบ [#4-ดูตัวอย่างและทดสอบ]
1. ใช้ลูกศรก่อนหน้า/ถัดไปเพื่อเลื่อนดูแถว
2. ยืนยัน **To:** และ body ที่ merge แล้ว (หัวเรื่องแสดงหัวเรื่องแม่แบบดิบ)
3. เมนูส่ง → **Send me a test email**
4. ตรวจสอบกล่องจดหมายของคุณ
รายละเอียด: [ดูตัวอย่างและทดสอบ](/features/preview-and-test)
## 5. ส่งหรือกำหนดเวลา [#5-ส่งหรือกำหนดเวลา]
* ปุ่มหลัก: **Send N email(s)** เมื่อมีผู้รับที่นับได้
* หรือ เมนูส่ง → **Schedule send** → เลือกวันที่/เวลา → **Schedule Send**
Busy overlay: `Starting your campaign…` / toast ยืนยันการกำหนดเวลา
MailG เพิ่มคอลัมน์แคมเปญเช่น `🚀 My Template (yyyy/MM/dd)` หรือ `🗓️ …` เมื่อกำหนดเวลา
สถานะแถว:
| สถานะ | ความหมาย |
| ------------- | ---------------------- |
| 🗓️ Scheduled | รอเวลาเริ่ม |
| ⏳ Sending… | กำลังประมวลผล |
| ✉️ Sent | ส่งไปยัง Gmail แล้ว |
| ⚠️ Failed | ข้อผิดพลาด |
| 👀 Opened | โหลดพิกเซลเปิดอ่านแล้ว |
## ข้อผิดพลาดที่พบบ่อย [#ข้อผิดพลาดที่พบบ่อย]
* แท็กในหัวเรื่องคาดหวังการปรับแต่ง — รองรับเฉพาะ body ในตอนนี้
* เซลล์ผู้รับมีหลายอีเมลคั่นด้วยเครื่องหมายจุลภาค — UI ตรวจสอบ**อีเมลเดียว**ต่อเซลล์สำหรับการนับ
* บัญชี Google ไม่ตรงกับบัญชีที่ติดตั้ง
* เกินโควตารายวัน — ตรวจ **Daily quota** ใน sidebar
## เคล็ดลับ [#เคล็ดลับ]
* ใช้ checklist **Help** ที่ footer ครั้งแรก
* เริ่มด้วย 2–3 แถวจริงหลัง mock data
* หลังมีการเปิดอ่าน: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → แจ้งเตือน `Tracking info synced` (หรือ `No active campaigns`)
## ถัดไป [#ถัดไป]
# MailG คืออะไร? (/th/getting-started/what-is-mailg)
MailG เปลี่ยน Google Sheet ให้เป็นแคมเปญ mail merge แต่ละแถวคือผู้รับหนึ่งคน ส่วนหัวคอลัมน์จะกลายเป็น merge tag (วงเล็บปีกกาคู่รอบชื่อหัวคอลัมน์) ใน **email body**
## สิ่งที่คุณทำได้ [#สิ่งที่คุณทำได้]
* สร้างแม่แบบบนคลาวด์ (**Template Name**, **Email Subject**, body แบบ rich text)
* ปรับแต่ง **body** ด้วย merge tag จากหัวคอลัมน์ในชีต
* ดูตัวอย่างแถวและ **Send me a test email**
* แมป **CC** / **BCC**, **Sender name**, **Reply to address**
* **Schedule send** หรือส่งทันที
* **Track emails** พร้อมชิปสถานะการเปิดอ่านในชีต
* ควบคุม **Send pacing** ในแผนแบบชำระเงิน
* **Remove branding** ในแผนแบบชำระเงิน
* ติดตาม **Daily quota** (และอาจรับโบนัสรีวิวฟรี)
## องค์ประกอบทั้งหมดเชื่อมกันอย่างไร [#องค์ประกอบทั้งหมดเชื่อมกันอย่างไร]
1. **Google Sheets add-on** — กล่องโต้ตอบภายใต้ **MailG for Gmail**
2. **MailG API** — แม่แบบ metadata แคมเปญ การติดตามการเปิดอ่าน และสิทธิ์การใช้งาน
3. **Gmail ของคุณ** — ส่งข้อความด้วย `GmailApp` จากบัญชีที่อนุญาตแล้ว
## ขั้นตอนถัดไป [#ขั้นตอนถัดไป]
# お問い合わせ (/ja/contact-us)
## 請求とサブスクリプション [#請求とサブスクリプション]
サブスクリプションの変更のほとんどは、[pricing](https://app.mailg.io/pricing?lang=ja) からリンクされた Stripe ポータルで管理できます。返金や支払いの問題については、メールでご連絡ください。
## その他 [#その他]
**[contact@mailg.io](mailto:contact@mailg.io)** までメールをお送りください。
通常、1 営業日以内に返信します。
## 便利なリンク [#便利なリンク]
* [ウェブサイト](https://www.mailg.io)
* [料金](https://app.mailg.io/pricing?lang=ja)
* [プライバシー](https://www.mailg.io/ja/privacy)
* [利用規約](https://www.mailg.io/ja/terms)
* [ドキュメントホーム](/)
# MailG ドキュメント (/ja)
MailG は Gmail 向け mail merge 用の Google Sheets アドオンです。**Extensions → MailG for Gmail → 🚀 Start** を開き、テンプレートを作成し、行をプレビューしてから、ご自身の Gmail アカウントから送信またはスケジュールします。
## ここから始める [#ここから始める]
## 人気のトピック [#人気のトピック]
## 便利なリンク [#便利なリンク]
* ウェブサイト: [www.mailg.io](https://www.mailg.io)
* ドキュメント: [docs.mailg.io/ja](https://docs.mailg.io/ja)
* 料金: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=ja)
* お問い合わせ: [contact@mailg.io](mailto:contact@mailg.io)
## AIアシスタント / LLM向け [#aiアシスタント--llm向け]
HTMLのスクレイピングより、これらの機械可読エンドポイントを優先してください：
* [Agents hub](https://www.mailg.io/ja/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/ja/help/faq)
## インストールと起動 [#インストールと起動]
**MailG を開くには？**\
**Extensions → MailG for Gmail → 🚀 Start**。[インストール](/getting-started/installation) を参照。
**No email address found in your sheet**\
列にメールを追加するか **Fill with mock data** をクリック。[スタートダイアログのツアー](/getting-started/start-dialog) を参照。
**Could not reach the MailG API**\
ネットワーク / API URL を確認（セルフホスト：`APP_URL` + `APP_API_KEY`）。修正後にダイアログを再開。
## 送信 [#送信]
**メールが送信されない**\
**Daily quota**、Gmail 権限、**Recipient column** セルが有効な単一メールか確認。失敗は **⚠️ Failed** を表示。
**件名マージタグは使える？**\
まだ。**本文** のみマージ。固定件名にするかパーソナライズは本文へ。[マージタグ](/features/merge-tags) を参照。
**ファイルを添付できる？**\
**Attachments** ピッカーは **More options** 配下にあるが、送信時にファイルはまだ添付されない。リンクを使う。
**キャンペーンを止めるには？**\
[キャンペーンの停止](/features/stopping-a-campaign) — 残り行の送信可能ステータスをクリア。
**Professional なのに制限される理由は？**\
MailG は 1 日 1,500 通まで許可する場合があるが、無料 `@gmail.com` は Google により約 500 通付近で上限されることが多い。
## トラッキング [#トラッキング]
**開封後もシートが Sent のまま**\
**🔄 Refresh Tracking** → `Tracking info synced` を期待。画像を読み込まないクライアントもある。
**クリックは？**\
トラッキング対象外。**Track emails** = 開封のみ。
## クォータと請求 [#クォータと請求]
[Daily quota & reviews](/help/daily-quota-and-reviews) と [アカウントと請求](/help/account-and-billing) を参照。
**Schedule send は有料？**\
いいえ。有料で解放されるのはより高いクォータ、ペーシングモード、**Remove branding**。
## トラブルシューティング [#トラブルシューティング]
段階的な修正（API エラー、空シート、送信ボタン無効、失敗行、トラッキング、クォータ、スケジュールが延期されない）は [トラブルシューティング](/help/troubleshooting) を参照。
表示されうる一般的なトースト：
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## まだ解決しない？ [#まだ解決しない]
[トラブルシューティング](/help/troubleshooting) · ドキュメント [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# トラブルシューティング (/ja/help/troubleshooting)
アドオンで見えるメッセージと状態向けのクイック修正。
## ダイアログが読み込めない [#ダイアログが読み込めない]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
スタートダイアログが MailG バックエンドを呼べませんでした。
* オンラインか確認
* Marketplace インストール：少し待って **🚀 Start** を再開
* セルフホスト：Apps Script プロパティ `APP_URL`（公開 HTTPS）と `APP_API_KEY` を確認
* アドオンは `localhost` を使えない — ローカル API テストにはトンネルを使用
### Could not read your sheet [#could-not-read-your-sheet]
MailG がアクティブなスプレッドシートを読めませんでした。
* シートタブが開いているか確認（Apps Script エディターのみではない）
* スプレッドシートを再読み込みし、ダイアログを再開
* ファイルへの編集アクセスがあるか確認
### Loading… が終わらない [#loading-が終わらない]
ダイアログを閉じ、Sheets を更新し、Extensions の読み込みまで約 15 秒待ってから **🚀 Start** を再度。
## 空シート [#空シート]
**No email address found in your sheet**
MailG には有効なメールアドレスが 1 列以上必要。
* ヘッダー下にメールを追加するか **Fill with mock data** をクリック
* モックデータは `Email`、`First Name`、`Last Name`、`Company` を作成し、多くの場合 **My First Template** も作成
[スタートダイアログのツアー](/getting-started/start-dialog) を参照。
## テンプレート [#テンプレート]
* 作成：`Creating Template...` → `Template created successfully!` または `Failed to create template! Try again later.`
* 更新：`Updating template...`
* 削除失敗：`Failed to delete template. Try again later`
[テンプレート](/features/templates) を参照。
## 送信の問題 [#送信の問題]
### 送信ボタン無効 / 件数なしの Send emails [#送信ボタン無効--件数なしの-send-emails]
* **Template** を選択
* セルあたり有効な **単一** メールがある **Recipient column** を選択
* 表示されうるガードトースト：`Configure your recipient column first`、`Select a template first.`、`No valid recipient emails found in the selected column.`
### キャンペーン開始失敗 [#キャンペーン開始失敗]
トースト：`Failed to create campaign. Please try again.`
* 一度再試行
* **Daily quota** が 0 でないか確認
* API 接続を確認（上記参照）
### 行に ⚠️ Failed [#行に-️-failed]
その行で送信エラー（無効アドレス、Gmail 拒否、一時的クォータなど）。データを修正し残り行向けに新キャンペーンを開始するか、[キャンペーンの停止](/features/stopping-a-campaign) を参照。
### テストメール失敗 [#テストメール失敗]
* `Configure your preview first` — To があるようテンプレート + 受信者を選択
* `Failed to send test email. Please check your email settings.` — 必要なら Gmail を再認可して再試行
## トラッキング [#トラッキング]
* 開封には受信者側でリモート画像の読み込みが必要
* **🔄 Refresh Tracking** を実行 — `Tracking info synced` または `No active campaigns` を期待
* ステータス **👀 Opened** はピクセル読み込み時のみ表示
[メールトラッキング](/features/email-tracking) を参照。
## クォータとブランディング [#クォータとブランディング]
* サイドバーの **N left** は `min(MailG remaining, Gmail remaining)`
* 無料 `@gmail.com` は Professional でも Google により約 500/日付近で上限されることが多い
* 支払い後も透かしあり → チェックアウトメール = Sheets アカウントメール；ダイアログを再開
[Daily quota & reviews](/help/daily-quota-and-reviews) と [ブランディング削除](/features/remove-branding) を参照。
## スケジュールが延期されない [#スケジュールが延期されない]
約 **15 秒** 以内の時刻は **即時** 送信（🚀 列）として扱われ、延期 🗓️ スケジュールにはならない。より先の時刻を選ぶ。
## まだ解決しない？ [#まだ解決しない]
FAQ 全文：[FAQ](/help/faq) · メール [contact@mailg.io](mailto:contact@mailg.io) · サイト [app.mailg.io/help](https://www.mailg.io/ja/help)
# Daily quota とレビュー (/ja/help/daily-quota-and-reviews)
ルートサイドバーは、アカウントデータ読み込み時に送信能力を表示します。
## Daily quota ブロック [#daily-quota-ブロック]
正確な UI：
* ラベル：**Daily quota**
* 残数：**N left**
* プラン行：**Your plan sends up to TOTAL/day**
**Remaining** は次の最小値：
1. その日の MailG プラン残数
2. アカウントの Gmail 残送信クォータ
MailG 上では余裕があっても Gmail で上限になることがあります。[アカウントと請求](/help/account-and-billing) も参照。
## 無料プラン CTA [#無料プラン-cta]
未加入時、サイドバーに表示される場合：
* **Leave a 5★ review for +N/day free**（API が別指定しない場合、デフォルトボーナス **+50/day**）
* **Or upgrade your plan**
レビュー CTA をクリックすると **Free Quota upgrade** が開く：
* タイトル：**Free Quota upgrade**
* 本文：5 つ星レビューで **+N emails/day** の無料クォータアップグレード
* ボタン：**Not now** | **Leave a 5★ review**
レビュー URL が未設定の場合、**Leave a 5★ review** は無効のまま — **Upgrade to Pro** / pricing を使用。
## Proにアップグレード [#proにアップグレード]
フッターボタン（無料アカウント）：**Upgrade to Pro**
Tooltip：`Unlock higher quota, send pacing, and remove branding`
これは現在有料プランが解放する内容と一致。
## 関連 [#関連]
* [ブランディング削除](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# アカウントと請求 (/ja/help/account-and-billing)
MailG の請求は Sheets の **Google アカウントのメール** に紐づきます。アドオンでクォータが解放されるよう、必ず同じアドレスでチェックアウトしてください。
## プランと日次クォータ [#プランと日次クォータ]
| プラン | 日次クォータ | 備考 |
| ------------ | ------ | --------------------- |
| Free | 50 | コアマージ、開封トラッキング、スケジュール |
| Personal | 250 | リスト拡大向けの人気プラン |
| Professional | 1,500 | 最高の定期クォータ |
| Lifetime | 1,500 | 買い切り |
価格と請求間隔は [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=ja)（EUR と USD）に記載。
有料権限で追加解放：
* デフォルト以外の [send pacing](/features/send-pacing)（**Steady pace** / **Jittered gaps**）
* [Remove branding](/features/remove-branding)
実効送信量は `min(MailG daily quota, Gmail remaining quota)`。
## アップグレード方法 [#アップグレード方法]
1. [pricing](https://app.mailg.io/pricing?lang=ja) を開く（アドオンから **Upgrade to Pro** でもリンク）。
2. プランを選び、Sheets の Google メールで Stripe Checkout を完了。
3. Sheets で MailG を再開し、アカウント更新で新しい上限を反映。
## サブスクリプションの解約または変更 [#サブスクリプションの解約または変更]
サブスクリプション / pricing フローにリンクされた Stripe カスタマーポータルから解約または変更できます。
* サイクル途中で解約しても、Premium 機能は有料期間終了まで有効
* 解約が有効になった後は再請求されない
## 返金 [#返金]
Premium サブスクリプションを購入から **30 日** 以内に解約した場合、[contact@mailg.io](mailto:contact@mailg.io) にメールで全額返金を請求できます。
## 請求書 [#請求書]
Stripe は成功した支払いの領収書をメール送信。サブスクリプション管理用 Stripe カスタマーポータルから請求書をダウンロードも可能。
## FAQ 抜粋 [#faq-抜粋]
**MailG は Google Workspace に含まれる？**\
いいえ。MailG は Google とは独立。Workspace サブスクリプションに MailG は含まれない。
**利用できる支払い方法は？**\
主要カード、Google Pay、Apple Pay（Stripe 経由）。PayPal は非対応。
**支払ったのに無料上限／透かしのまま**\
ほぼ常にメール不一致。チェックアウトメール = Sheets アカウントメールを確認し、アドオンを再開。続く場合は両方のメールを添えてサポートに連絡。
**無料 Gmail が 1 日約 500 通に制限される理由は？**\
MailG Professional は 1 日 1,500 通まで許可するが、Google 自体が無料 `@gmail.com` を 1 日おおよそ 500 通に制限。Google Workspace アカウントはより高くできる。これは Gmail プロバイダー制限であり、MailG 制限ではない。
# キャンペーンスケジュール (/ja/features/campaign-scheduling)
後から開始したい場合は **Schedule send** を使用。無料・有料プランで利用可能。
## スケジュール方法 [#スケジュール方法]
1. 送信ボタンが有効になるようテンプレートと受信者を設定。
2. 送信メニュー（シェブロン）→ **Schedule send**。
3. ダイアログタイトル：**Schedule send**
4. 説明：`Pick date & time to schedule sending`
5. サマリー行：選択した日時から N 通のメール送信をスケジュール
6. 日付ピッカーと **Hour** / **Minute**（プレースホルダー `Hour`、`Min`）を使用。
7. **Schedule Send** で確定（または **Cancel**）。
デフォルト提案は約 **60 分後**、次の **15 分** 刻みにスナップ。
## 即時 vs スケジュール [#即時-vs-スケジュール]
約 **15 秒** 以内の時刻は **即時** 送信（🚀 列ヘッダー）として扱われ、延期 🗓️ スケジュールにはなりません。延期送信が必要なら、より先の時刻を選んでください。
検証トースト：`Please select a date and time`、`Invalid date and time`、`Pick a date and time in the future`。
成功トースト：キャンペーンがスケジュールされ、選択時刻に N 通が開始。
## シート列 [#シート列]
スケジュールキャンペーンは次のような列ヘッダーを作成：
```text
🗓️ Template name (yyyy/MM/dd)
```
即時送信は 🗓️ の代わりに 🚀 を使用。
行は最初 **🗓️ Scheduled** で、キュー実行時に **⏳ Sending…** に移行。
## スケジュール後 [#スケジュール後]
* アドオンを所有する Google アカウントからスプレッドシートにアクセスできるようにする
* 送信開始後もトラッキングとペーシングは適用される
* **Manage Schedule** UI はなし — [キャンペーンの停止](/features/stopping-a-campaign) を参照
## 関連 [#関連]
* [プレビューとテスト](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# 複数受信者 (/ja/features/multiple-recipients)
専用シート列で行ごとに CC 受信者を追加できます。
## 受信者列（To） [#受信者列to]
サイドバーで **Recipient column** を選択。
送信ボタンの件数と列検証のため、MailG はセルが **単一** メールアドレスのとき有効とみなします。行あたり 1 つの主 To アドレスを推奨。
## CC と BCC 列 [#cc-と-bcc-列]
1. シートに列を追加（例：`CC`、`BCC`）。
2. セルにメール（または Gmail が受け付けるリスト）を入力。
3. **More options** を開き **CC** / **BCC** をマッピング。
4. 送信時、それらの値が Gmail に渡されます。
プレビューペインは **From**、**To**、**Subject**、本文のみ表示。**CC**/**BCC** 行はマッピングしていても **表示されません**。CC/BCC 配信を確認するには **Send me a test email** を使ってください。
## クォータ：MailG vs Gmail [#クォータmailg-vs-gmail]
* **MailG 日次クォータ** は処理した **キャンペーン行** をカウント。
* **Gmail 送信制限** は **受信者**（その送信で Gmail が受け付けた To + CC + BCC アドレス）をカウント。
MailG クォータに余裕があっても Gmail の上限に達することがあります。
## ヒント [#ヒント]
* 受信者同士に見えてほしくない場合は **BCC** を推奨
* 使わない CC/BCC はマッピングしない
* 大量送信前にアドレスを検証
# Attachments (/ja/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# 機能概要 (/ja/features/features-overview)
アドオンが現在サポートする内容：
| 機能 | ドキュメント |
| ------------------------- | ------------------------------------------------------ |
| スタートダイアログ / 空シート / モックデータ | [スタートダイアログのツアー](/getting-started/start-dialog) |
| テンプレート（作成 / 管理 / 編集 / 削除） | [テンプレート](/features/templates) |
| **本文** 内のマージタグ | [マージタグ](/features/merge-tags) |
| リッチテキストツールバー | [リッチテキストメール](/features/rich-text-emails) |
| リンク（画像埋め込みではない） | [画像](/features/images) |
| プレビュー + テストメール | [プレビューとテスト](/features/preview-and-test) |
| Schedule send | [キャンペーンスケジュール](/features/campaign-scheduling) |
| Send pacing（有料） | [Send pacing](/features/send-pacing) |
| CC / BCC 列 | [複数受信者](/features/multiple-recipients) |
| Track emails | [メールトラッキング](/features/email-tracking) |
| 送信者名と返信先 | [送信者のカスタマイズ](/features/customized-sender) |
| Remove branding（有料） | [ブランディング削除](/features/remove-branding) |
| 残り行の停止 | [キャンペーンの停止](/features/stopping-a-campaign) |
| Daily quota + レビューボーナス | [Daily quota & reviews](/help/daily-quota-and-reviews) |
## 有料 vs 無料 [#有料-vs-無料]
有料で解放されるもの：
* デフォルト以外の [send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* より高い [日次クォータ](/help/account-and-billing)
**Schedule send**、**Track emails**、テンプレートツールは有料アップグレードなしで利用できます。
## 既知のギャップ（正直に） [#既知のギャップ正直に]
| トピック | 製品内の状態 |
| ----------------------- | ---------------------- |
| 件名マージタグ | 送信時に適用されない — 本文のみ |
| Attachments 列 | UI のみ — 送信時に添付されない |
| 画像埋め込み | エディターコントロールなし — リンクを使用 |
| プレビューの CC/BCC 行 | プレビュー UI に表示されない |
| Manage Schedule / Pause | 未提供 — ステータスでの回避策 |
## 今後 [#今後]
配信停止リンク、クリックトラッキング、共有チーム席、専用キャンペーンマネージャー UI は、提供開始時に追加されます。
# メールトラッキング (/ja/features/email-tracking)
MailG は小さな不可視ピクセルで開封を記録できます。
## トラッキングを有効化 [#トラッキングを有効化]
サイドバーで **Track emails** をオン（新規ジョブのデフォルトはオン）。
Tooltip：`Track emails opened with a tiny pixel`
ヘルプアイコンは **Email tracking** を開く：
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
ボタン：**Got it**
## シートステータス [#シートステータス]
| ステータス | 意味 |
| ------------- | ---------------- |
| 🗓️ Scheduled | スケジュール開始待ち |
| ⏳ Sending… | 現在処理中 |
| ✉️ Sent | その行は Gmail に配信済み |
| ⚠️ Failed | その行の送信エラー |
| 👀 Opened | 開封ピクセルが読み込まれた |
キャンペーン列ヘッダーは `🚀 Template name (yyyy/MM/dd)` やスケジュール時は `🗓️ …` の形式。
## トラッキングを更新 [#トラッキングを更新]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Apps Script アラート：
* `Tracking info synced`
* `No active campaigns`
## 制限 [#制限]
* クライアントがリモート画像を読み込む必要がある
* プライバシープロキシで開封が隠れることがある
* 開封のみ — リンククリックは対象外
## 関連 [#関連]
* [キャンペーンスケジュール](/features/campaign-scheduling)
* [FAQ](/help/faq)
# マージタグ (/ja/features/merge-tags)
マージタグにより、受信者ごとに **本文** をパーソナライズできます。タグは **列ヘッダー名をそのまま** 二重中括弧で囲んだものです。
## 構文 [#構文]
シートに `First Name` 列がある場合：
```text
{{First Name}}
```
本文の例：
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## マージタグが使える場所（現状） [#マージタグが使える場所現状]
| フィールド | 送信時にマージ？ |
| ------- | ----------------------------- |
| メール本文 | **はい** — 行ごとに変数を注入 |
| メール件名 | **いいえ** — テンプレートに保存された件名のまま送信 |
| プレビュー本文 | **はい** — アクティブ行向け |
| プレビュー件名 | **いいえ** — 生のテンプレート件名を表示 |
件名マージが提供されるまで、パーソナライズは本文に置いてください。
## タグの挿入 [#タグの挿入]
エディターツールバーで **Merge Tag** を開きます。アクティブシートのヘッダーが一覧表示されます。空の状態：`No sheet columns found`。
挿入されるテキストは列名を二重中括弧で囲んだ形式です。
## 覚えておくこと [#覚えておくこと]
* ヘッダーは大文字小文字を区別（`Name` ≠ `name`）
* 空セルは空文字列として挿入
* 本文内で同じタグを複数回使える
* 受信者 / CC / BCC は **More options** で選択 — マージタグではない
## 次へ [#次へ]
[リッチテキストメール](/features/rich-text-emails) と [プレビューとテスト](/features/preview-and-test) を参照。
# リッチテキストメール (/ja/features/rich-text-emails)
MailG テンプレートは TipTap リッチテキストエディターを使用します。生成される HTML が Gmail に配信されます。
本文プレースホルダー：`Write your email…`
## ツールバー一覧（正確な UI） [#ツールバー一覧正確な-ui]
| グループ | コントロール |
| ----------- | --------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**、**Arial**、**Georgia**、**Times New Roman**、**Verdana**、**Courier New** |
| Font size | **10pt** … **24pt**（ツールバーのプリセット） |
| Marks | **Bold**、**Italic**、**Underline**、**Strikethrough**、**Text color**、**Clear formatting** |
| Color | プリセットスウォッチ + ネイティブカラーピッカー + **Reset** |
| Align | **Align left**、**Align center**、**Align right**、**Justify** |
| Lists | **Bullet list**、**Numbered list** |
| Link | **Insert link** — URL フィールドプレースホルダー `https://example.com`、続けて **Apply**（およびリンク解除） |
| History | **Undo**、**Redo** |
## エディターにないもの [#エディターにないもの]
以下の TipTap 機能は無効／未搭載：
* 見出し、コード、コードブロック、引用、水平線
* 画像挿入 / Drive メディアピッカー — [画像](/features/images) を参照
## ハイパーリンク [#ハイパーリンク]
URL と表示テキストには **Insert link** を使用。生 URL より分かりやすいリンクテキストを推奨。
## ヒント [#ヒント]
* 手入力の括弧より **Merge Tag** を使う
* 送信前に複数行をプレビュー — [プレビューとテスト](/features/preview-and-test) を参照
* Word/Docs からの巨大な貼り付けマークアップは避け、MailG で書式を付け直すと HTML がきれいになる
# MailG ブランディングの削除 (/ja/features/remove-branding)
無料キャンペーンにはメールフッターに小さな MailG 透かしが含まれる場合があります。有料加入者はオフにできます。
## ブランディングを削除する方法 [#ブランディングを削除する方法]
1. 有効な有料プラン（Personal、Professional、Lifetime）であることを確認。
2. キャンペーンサイドバーを開く。
3. **Remove branding** を有効化。
4. 行をプレビューして透かしが消えたことを確認し、送信。
支払い後も透かしが残る場合：
* チェックアウトが Google スプレッドシート アカウントと **同じメール** だったか確認
* アドオンを再開して API から権限を更新
* Google アカウントのメールを添えて [contact@mailg.io](mailto:contact@mailg.io) に連絡
[アカウントと請求](/help/account-and-billing) を参照。
# 画像 (/ja/features/images)
MailG エディターには **画像挿入ボタン** も Google Drive メディアピッカーもありません。TipTap の Image 拡張は有効になっていません。
## 現時点でできること [#現時点でできること]
ツールバーの **Insert link** を使用：
1. 画像（またはファイル）を公開 URL でホストするか、Drive リンクを共有。
2. テキストを選択（またはカーソルを置く）→ **Insert link**。
3. URL を貼り付け（プレースホルダー `https://example.com`）→ **Apply**。
受信者はリンクを開いて画像またはファイルを表示します。エディターは `![]()
` タグを自動で埋め込みません。
## ヒント [#ヒント]
* 小さなファイルと分かりやすいリンクテキスト（「View screenshot」）を推奨
* ログインが必要なリンクは受信者側で失敗する
* **Send me a test email** で確認
## 今後 [#今後]
画像埋め込み / Drive ピッカーの第一級サポートは将来提供される可能性があります。それまではハイパーリンクがサポートされる方法です。
# テンプレート (/ja/features/templates)
テンプレートはキャンペーン間で再利用する件名とリッチテキスト本文を保存します。Google アカウント向けに MailG API に保存されます。
## テンプレートを作成 [#テンプレートを作成]
1. ルート画面で **New Template** をクリック。
2. 入力：
* **Template Name**
* **Email Subject**
* 本文（リッチエディター — [リッチテキストメール](/features/rich-text-emails) を参照）
3. **Save Template** をクリック（処理中は **Saving...** を表示）。
トースト：
* 読み込み：`Creating Template...`
* 成功：`Template created successfully!`
* エラー：`Failed to create template! Try again later.`
**Fill with mock data** からのデモテンプレート：名前 **My First Template**、件名 `I found a mail merge tool for Gmail`。
## テンプレートを管理 [#テンプレートを管理]
テンプレート select の横のアイコンを開く（tooltip **Manage templates**）。
表の列：
| 列 | 内容 |
| ----------------- | ------- |
| **Name** | テンプレート名 |
| **Email Subject** | 件名行 |
| **Created At** | 作成日 |
| **Actions** | 行メニュー |
行メニュー：**Edit** | **Delete**
フッター：**Back**
削除トースト：deleting template NAME → template NAME deleted successfully（または失敗メッセージ）。
## テンプレートを編集 [#テンプレートを編集]
管理から **Edit** を開くか、プレビューツールバーの **Edit template** をクリック。
作成時と同じフィールド。**Save Template** でテンプレートを更新。
更新フローは読み込みトースト（`Updating template...`）を表示します。完了までフォームに留まり、自動で戻らない場合は **Cancel** または **Back** を使ってください。
## 件名 vs 本文 [#件名-vs-本文]
* **本文** は [マージタグ](/features/merge-tags) をサポート — 送信時に行ごとに注入されます。
* **Email Subject** は現状保存どおり送信されます（件名内のマージタグは **まだ** 置換されません）。パーソナライズは本文に置くか、固定件名を使ってください。
## 関連 [#関連]
* [プレビューとテスト](/features/preview-and-test)
* [スタートダイアログのツアー](/getting-started/start-dialog)
# プレビューとテスト (/ja/features/preview-and-test)
プレビューペイン（ルートダイアログ右側）は、アクティブなシート行向けのメッセージ見た目を表示します。
## プレビューに表示されるもの [#プレビューに表示されるもの]
| フィールド | 内容 |
| ------------ | --------------------------------------------------------------- |
| **From:** | サインイン中の Google アカウントのメール |
| **To:** | アクティブ行の **Recipient column** の値、または `Select a recipient column` |
| **Subject:** | 保存されたテンプレート件名（マージ置換なし） |
| 本文 | その行向けにマージタグを適用したテンプレート本文 |
**Remove branding** がオフの場合、プレビューに MailG 透かしフッター（`made and sent with` / **MailG** / `Email Marketing from Gmail`）が含まれます。
## 表示されないもの [#表示されないもの]
* **CC** / **BCC** 行はプレビュー UI に描画されません（**More options** でマッピングしていても）。送信時には適用されます。
* Attachments 列の値はプレビューに表示されません。
## 行を移動 [#行を移動]
プレビューツールバー：
* **Edit template** — テンプレート更新画面を開く
* **Previous recipient** / **Next recipient** — データ行間を移動（tooltip にシート行番号が含まれる場合あり；ヘッダーは 1 行目なので最初の連絡先は 2 行目）
## テストメールを自分に送る [#テストメールを自分に送る]
1. プレビューが有効になるようテンプレート + 受信者列を設定。
2. 送信メニュー（シェブロン）→ **Send me a test email**。
3. 処理中オーバーレイ：`Sending test email…`
4. 成功トースト：`Test email sent successfully. Check your inbox.`
5. 失敗トースト：`Failed to send test email. Please check your email settings.`
6. プレビュー未完成時のガード：`Configure your preview first`
テストは **あなたの** Google アカウント受信トレイに送られ、アクティブプレビュー行のマージ済み本文を使用します。
## ヒント [#ヒント]
* 一括送信前に矢印で複数行を確認
* プレビューでブランディングあり／なしを確認
* **Schedule send** や大量の **Send N email(s)** の前に必ずテスト
## 関連 [#関連]
* [マージタグ](/features/merge-tags)
* [メールマージチュートリアル](/getting-started/mail-merge-tutorial)
# 送信ペース (/ja/features/send-pacing)
Send pacing はメッセージ間に遅延を入れ、大規模キャンペーンが一気に送信されないようにします。
**Steady pace** と **Jittered gaps** には有効な MailG 有料サブスクリプションが必要です。無料アカウントは **Burst send** のみ。
## 設定場所 [#設定場所]
フッターの歯車を開く（tooltip **Send pacing**）。画面見出し：**Send pacing**。
**Dispatch mode** でメール間隔の方式を選択。**Gap between emails** は **秒**（0〜60）で設定。無料アカウントには **Pro features** とロック文言：`Free plans use burst send only. Upgrade to Pro to space out your campaigns.` が表示されます。
新規ジョブのデフォルト：**Burst send**、間隔 **10s**（burst を離れるまで間隔は無視）。
## モード [#モード]
| モード（UI ラベル） | 動作 |
| --------------------- | ------------------------ |
| **Burst send**（デフォルト） | クォータの範囲で可能な限り速く送信 |
| **Steady pace** | 各メールの間に固定間隔を待つ |
| **Jittered gaps** | 0 から選択した最大値の間でランダムな間隔を待つ |
## ペーシングを使う理由 [#ペーシングを使う理由]
* メールプロバイダーに突然の一斉送信と見えにくくする
* 長いリストを静かな送信ウィンドウに分散
* アカウント種別に応じた Gmail の許容範囲内に留める
## 注意 [#注意]
* ペーシングはジョブと一緒に保存されるキャンペーン設定 — 新規送信は現在の設定を使用
* 大きなリストに長い間隔を設定すると、キャンペーン全体の時間が大幅に増える
* 実効速度は MailG 日次クォータ **と** Gmail の残送信クォータの両方で上限される
* 競合ツールは分単位の遅延を使うことがある — MailG は **秒** を使用
## 関連 [#関連]
* 実行中に間隔を高くしすぎた場合 [キャンペーンの停止](/features/stopping-a-campaign)
* [アカウントと請求](/help/account-and-billing)
# キャンペーンの停止 (/ja/features/stopping-a-campaign)
MailG には競合製品のような専用 **Manage Schedule**、**Abort**、**Pause** 画面はまだありません。それでも **残り** の行の送信は止められます。
## 送信対象の判定 [#送信対象の判定]
送信ループは、キャンペーン列ステータスがまだ送信可能な行のみ処理：
* ⏳ Sending… / レガシー `Pending...`
* 🗓️ Scheduled / レガシー `Scheduled`
すでに **✉️ Sent**、**⚠️ Failed**、**👀 Opened** の行はスキップ。
## 残り行を停止（正直な回避策） [#残り行を停止正直な回避策]
大規模キャンペーンでは素早く：
1. スプレッドシートを開く。
2. キャンペーンステータス列で、送信 **してはいけない** 行のステータスをクリアまたは変更（例：セル値を削除、または `Stopped` など送信不可ラベルを設定）。
3. すでに **✉️ Sent** の行は触らない — それらのメッセージはすでに送信済み。
クリア／変更した行は送信可能ステータスに一致しなくなり、次のパスでキューがスキップします。
すでにアカウントから出た Gmail メッセージは MailG では取り消せません。停止できるのはまだ処理されていない行のみ。
## まだ開始していないスケジュールキャンペーン [#まだ開始していないスケジュールキャンペーン]
すべての行がまだ **🗓️ Scheduled** で開始時刻前なら、それらのステータス（またはキャンペーン列）をクリアすると、時刻になってもキューが拾いません。
不明な場合は、スプレッドシート URL とキャンペーン詳細を添えて [contact@mailg.io](mailto:contact@mailg.io) に連絡してください。
## 関連 [#関連]
* [キャンペーンスケジュール](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# 送信者のカスタマイズ (/ja/features/customized-sender)
デフォルトでは、MailG を認可した Google アカウントから Gmail が送信されます。表示名と返信先はカスタマイズできます。
## 送信者名 [#送信者名]
1. キャンペーンサイドバーで **More options** を開く。
2. **Sender name** を設定（プレースホルダー `John Doe (Optional)`）。
3. 受信者の受信トレイにはその表示名が表示されます（Gmail の通常の表示ルールに従う）。
## 返信先アドレス [#返信先アドレス]
返信を送信アカウント以外に送りたい場合は **Reply to address** を設定（プレースホルダー `john@doe.com (Optional)`）。
## 注意 [#注意]
* 基礎となる From アドレスは認可済み Gmail アカウントのまま — 別メールボックスを偽装できない
* 無効な reply-to は配信または返信の問題を起こす — 管理するメールボックスを使う
* プレビューの **From:** はサインイン中のメール；reply-to は **Send me a test email** で確認
* [プレビューとテスト](/features/preview-and-test) を参照
# スタートダイアログのツアー (/ja/getting-started/start-dialog)
**Extensions → MailG for Gmail → 🚀 Start** でアドオンを開きます。**MailG for Gmail** というタイトルの 900×600 ダイアログが開きます。
## 画面 [#画面]
| 画面 | 遷移方法 | 目的 |
| ---------------- | ---------------------------------------- | ----------------------- |
| Root（コンポーザー） | 読み込み後のデフォルト | テンプレートと受信者を選び、プレビューして送信 |
| Create template | **New Template** | 名前、件名、本文 |
| Manage templates | テンプレートアイコン（tooltip **Manage templates**） | 一覧、編集、削除 |
| Update template | **Edit template** または行の **Edit** | 既存テンプレートを編集 |
| Settings | フッターの歯車（tooltip **Send pacing**） | ディスパッチモードと間隔 |
| Empty sheet | 有効なメール列なし | 連絡先またはモックデータを追加するよう促す |
| API / シートエラー | 読み込み失敗 | 再試行の案内 |
## ルートレイアウト [#ルートレイアウト]
3 つのゾーン：
1. **Sidebar**（左）— テンプレート、受信者列、**More options**、トラッキング、ブランディング、クォータ
2. **Preview**（右）— From / To / Subject / 本文、行ナビ、**Edit template**
3. **Footer** — 送信ボタン、送信メニュー、**Upgrade to Pro**（無料）、設定、ヘルプ
## サイドバー（正確なラベル） [#サイドバー正確なラベル]
* **New Template**
* **Template**（select）— プレースホルダー `Select` または `No templates found`
* **Recipient column** — `A - Email` のようなオプション；空の場合：`No valid email columns found.`
* **More options** — **Attachments**、**CC**、**BCC**、**Sender name**、**Reply to address** を展開
* **Track emails**（デフォルトでオン）
* **Remove branding**（有料）
* **Daily quota** — 残数は「N left」、プラン行は「Your plan sends up to TOTAL/day」
無料アカウントには **Leave a 5★ review for +N/day free** と **Or upgrade your plan** も表示されます。[Daily quota & reviews](/help/daily-quota-and-reviews) を参照。
## フッターの送信コントロール [#フッターの送信コントロール]
| コントロール | ラベル |
| ----------- | ------------------------------------------------------------------------------------ |
| プライマリボタン | **Send N email(s)**（件数 0 のときは **Send emails**） |
| 送信メニュー | **Send me a test email** |
| 送信メニュー | **Schedule send** |
| アップグレード（無料） | **Upgrade to Pro** — tooltip：`Unlock higher quota, send pacing, and remove branding` |
| 歯車 | tooltip **Send pacing** |
| ヘルプ | tooltip **Help** — ダイアログ内チェックリストを開く |
### Need help? checklist [#need-help-checklist]
1. Pick a template and recipient column
2. Preview each row with the arrows
3. Send a test email to yourself first
4. Click Send to merge from your sheet
ボタン：**Open docs**（[docs.mailg.io](https://docs.mailg.io) を開く）| **View pricing**（利用可能な場合）| **Close**
## 空シート [#空シート]
MailG が有効なメール列を見つけられない場合：
* タイトル：**No email address found in your sheet**
* アクション：**Close** | **Fill with mock data**
モックデータは `Email`、`First Name`、`Last Name`、`Company` ヘッダーを作成し、**My First Template** を作成することがあります。
## エラー画面 [#エラー画面]
| タイトル | タイミング |
| --------------------------------- | -------------- |
| **Could not reach the MailG API** | API / ネットワーク失敗 |
| **Could not read your sheet** | シート読み取り失敗 |
## 次へ [#次へ]
# インストール (/ja/getting-started/installation)
2 ステップ：アドオンをインストールし、スプレッドシートから起動します。
## MailG をインストール [#mailg-をインストール]
1. [Google Workspace Marketplace の MailG ページ](https://workspace.google.com/marketplace/app/mailg) を開きます。
2. **Install** をクリックします。
3. インストールを所有する Google アカウントを選択します。
4. 権限を確認し、**Allow** をクリックします。
インストールは通常 15 秒以内に完了します。アドオンがインストールされた旨の確認が表示されます。
お住まいの地域で Marketplace 掲載がまだの場合は、[www.mailg.io](https://www.mailg.io) のインストール CTA を使うか、[contact@mailg.io](mailto:contact@mailg.io) までお問い合わせください。
## Google スプレッドシートで MailG を起動 [#google-スプレッドシートで-mailg-を起動]
1. [Google スプレッドシート](https://sheets.google.com) を開きます（既に開いている場合は更新してください）。
2. 拡張機能の読み込みまで数秒待ちます（多くの場合 10〜15 秒程度）。
3. **Extensions → MailG for Gmail → 🚀 Start** に進みます。
後から **Extensions → MailG for Gmail → 🔄 Refresh Tracking** を実行すると、フルダイアログを開かずに開封ステータスを同期できます。
## インストールの問題 [#インストールの問題]
以下は MailG の不具合ではなく、Google Workspace でよくある挙動です。
### 「installed successfully」ポップアップが出ない [#installed-successfullyポップアップが出ない]
複数の Google アカウントにサインインしており、想定と異なるアカウントでインストールされた場合に起こりがちです。
**回避策：** プライベート／シークレットウィンドウを開き、対象アカウントのみでサインインしてから、Marketplace から再インストールしてください。
### Extensions に MailG が表示されない [#extensions-に-mailg-が表示されない]
1. スプレッドシートを更新します。
2. アドオンの読み込みまで約 10〜15 秒待ちます。
3. MailG をインストールしたのと同じ Google アカウントか確認します。
4. まだ表示されない場合は別のスプレッドシートを試すか、ブラウザのキャッシュをクリアしてください。
## セルフホスト／カスタムデプロイ [#セルフホストカスタムデプロイ]
Marketplace インストールは事前設定済みです。MailG を自分でデプロイする場合は、Apps Script のスクリプトプロパティを設定します。
| プロパティ | 値 |
| ------------- | ----------------------- |
| `APP_URL` | MailG API の公開 HTTPS URL |
| `APP_API_KEY` | API サーバーと同じキー |
アドオンは Google のサーバーから `localhost` に到達できません — ローカルテストには Cloudflare Tunnel、ngrok などのトンネルを使ってください。
## 次へ [#次へ]
[メールマージチュートリアル](/getting-started/mail-merge-tutorial) に進んでください。
# メールマージチュートリアル (/ja/getting-started/mail-merge-tutorial)
このウォークスルーは **MailG for Gmail** のスタートダイアログに沿っています。
## 1. MailG を開く [#1-mailg-を開く]
**Extensions → MailG for Gmail → 🚀 Start**。
**No email address found in your sheet** が表示された場合は、実際のメールを追加するか **Fill with mock data** をクリックします（サンプル行と多くの場合 **My First Template** を作成）。[スタートダイアログのツアー](/getting-started/start-dialog) を参照。
## 2. テンプレートを作成または選択 [#2-テンプレートを作成または選択]
1. **New Template** をクリック（または **Template** で既存を選択）。
2. **Template Name** と **Email Subject** を設定（件名は現時点ではマージ置換されません）。
3. 本文を書き、**Merge Tag** で [マージタグ](/features/merge-tags) を挿入。
4. **Save Template**。
本文の例：
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. キャンペーンを設定 [#3-キャンペーンを設定]
サイドバーで：
1. **Recipient column** を選択（UI で件数に含めるにはセルが有効な単一メールである必要があります）。
2. **More options** を開き **CC**、**BCC**、**Sender name**、**Reply to address** を設定。
3. シートに開封ステータスが欲しければ **Track emails** をオン（デフォルト）のままに。
4. 有料プランでは **Remove branding** を有効化。
**Attachments** は **More options** 配下に表示されますが、送信時にファイルはまだ添付されません。本文に Drive または URL へのリンクを使ってください。
## 4. プレビューとテスト [#4-プレビューとテスト]
1. 前／次の矢印で行を進めます。
2. **To:** とマージ済み本文を確認（件名は生のテンプレート件名が表示されます）。
3. 送信メニュー → **Send me a test email**。
4. 受信トレイを確認。
詳細：[プレビューとテスト](/features/preview-and-test)。
## 5. 送信またはスケジュール [#5-送信またはスケジュール]
* プライマリボタン：受信者がカウントされているとき **Send N email(s)**。
* または送信メニュー → **Schedule send** → 日時を選択 → **Schedule Send**。
処理中オーバーレイ：`Starting your campaign…` / スケジュール確認トースト。
MailG は `🚀 My Template (yyyy/MM/dd)` やスケジュール時は `🗓️ …` のようなキャンペーン列を追加します。
行ステータス：
| ステータス | 意味 |
| ------------- | ------------- |
| 🗓️ Scheduled | 開始待ち |
| ⏳ Sending… | 処理中 |
| ✉️ Sent | Gmail に渡された |
| ⚠️ Failed | エラー |
| 👀 Opened | 開封ピクセルが読み込まれた |
## よくあるミス [#よくあるミス]
* 件名タグでパーソナライズを期待する — 現時点では本文のみ
* 受信者セルにカンマ区切りの複数アドレス — UI は件数用にセルあたり **1** 件のメールを検証
* インストールアカウントと異なる Google アカウント
* 日次クォータ超過 — サイドバーの **Daily quota** を確認
## ヒント [#ヒント]
* 初回はフッターの **Help** チェックリストを使う
* モックデータの後は 2〜3 行の実データから始める
* 開封後：**Extensions → MailG for Gmail → 🔄 Refresh Tracking** → アラート `Tracking info synced`（または `No active campaigns`）
## 次へ [#次へ]
# MailG とは？ (/ja/getting-started/what-is-mailg)
MailG は Google スプレッドシートをメールマージキャンペーンに変えます。各行が 1 人の受信者で、列ヘッダーは **メール本文** 内のマージタグ（ヘッダー名を二重中括弧で囲んだもの）になります。
## できること [#できること]
* クラウド保存のテンプレートを作成（**Template Name**、**Email Subject**、リッチ本文）
* シートのヘッダーからマージタグで **本文** をパーソナライズ
* 行をプレビューして **Send me a test email**
* **CC** / **BCC**、**Sender name**、**Reply to address** をマッピング
* **Schedule send** または即時送信
* シート内の開封ステータスチップで **Track emails**
* 有料プランで **Send pacing** を制御
* 有料プランで **Remove branding**
* **Daily quota** を確認（必要に応じて無料のレビューボーナスを取得）
## 全体の構成 [#全体の構成]
1. **Google スプレッドシート アドオン** — **MailG for Gmail** 配下のダイアログ
2. **MailG API** — テンプレート、キャンペーンメタデータ、開封トラッキング、権限
3. **あなたの Gmail** — 認可済みアカウントから `GmailApp` で送信
## 次のステップ [#次のステップ]
# Kontakt (/pl/contact-us)
## Rozliczenia i subskrypcje [#rozliczenia-i-subskrypcje]
Większość zmian subskrypcji możesz zarządzać z portalu Stripe powiązanego przez [pricing](https://app.mailg.io/pricing?lang=pl). W sprawie zwrotów lub problemów z płatnością napisz do nas.
## Wszystko inne [#wszystko-inne]
Wyślij e-mail na **[contact@mailg.io](mailto:contact@mailg.io)**.
Zwykle odpowiadamy w ciągu jednego dnia roboczego.
## Przydatne linki [#przydatne-linki]
* [Strona](https://www.mailg.io)
* [Cennik](https://app.mailg.io/pricing?lang=pl)
* [Prywatność](https://www.mailg.io/pl/privacy)
* [Regulamin](https://www.mailg.io/pl/terms)
* [Strona główna dokumentacji](/)
# Dokumentacja MailG (/pl)
MailG to dodatek Google Sheets do mail merge z Gmail. Otwórz **Extensions → MailG for Gmail → 🚀 Start**, utwórz szablon, podejrzyj wiersze, a następnie wyślij lub zaplanuj z własnego konta Gmail.
## Zacznij tutaj [#zacznij-tutaj]
## Popularne tematy [#popularne-tematy]
## Przydatne linki [#przydatne-linki]
* Strona: [www.mailg.io](https://www.mailg.io)
* Dokumentacja: [docs.mailg.io/pl](https://docs.mailg.io/pl)
* Cennik: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=pl)
* Kontakt: [contact@mailg.io](mailto:contact@mailg.io)
## Dla asystentów AI / LLM [#dla-asystentów-ai--llm]
Preferuj te maszynowo czytelne endpointy zamiast scrapować HTML:
* [Agents hub](https://www.mailg.io/pl/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# FAQ (/pl/help/faq)
## Instalacja i otwarcie [#instalacja-i-otwarcie]
**Jak otworzyć MailG?**\
**Extensions → MailG for Gmail → 🚀 Start**. Zobacz [Instalacja](/getting-started/installation).
**No email address found in your sheet**\
Dodaj e-maile do kolumny albo kliknij **Fill with mock data**. Zobacz [Przewodnik po oknie Start](/getting-started/start-dialog).
**Could not reach the MailG API**\
Sprawdź sieć / URL API (self-hosted: `APP_URL` + `APP_API_KEY`). Otwórz okno ponownie po naprawie.
## Wysyłka [#wysyłka]
**E-maile się nie wysyłają**\
Sprawdź **Daily quota**, uprawnienia Gmail i czy komórki **Recipient column** to prawidłowe pojedyncze e-maile. Błędy pokazują **⚠️ Failed**.
**Czy tagi scalania w temacie działają?**\
Jeszcze nie. Scalane jest tylko **body**. Użyj stałego tematu albo personalizacji w body. Zobacz [Tagi scalania](/features/merge-tags).
**Czy mogę dołączać pliki?**\
Picker **Attachments** jest pod **More options**, ale pliki nie są jeszcze dołączane przy wysyłce. Używaj linków.
**Jak zatrzymać kampanię?**\
[Zatrzymywanie kampanii](/features/stopping-a-campaign) — wyczyść wysyłalne statusy na pozostałych wierszach.
**Dlaczego mam limit na Professional?**\
MailG może pozwalać do 1500/dzień, ale darmowe `@gmail.com` Google często ogranicza do ok. 500.
## Śledzenie [#śledzenie]
**Arkusz nadal pokazuje Sent po otwarciu**\
**🔄 Refresh Tracking** → oczekuj `Tracking info synced`. Część klientów nigdy nie ładuje obrazów.
**Kliknięcia?**\
Nie są śledzone. **Track emails** = tylko otwarcia.
## Limit i rozliczenia [#limit-i-rozliczenia]
Zobacz [Dzienny limit i recenzje](/help/daily-quota-and-reviews) i [Konto i rozliczenia](/help/account-and-billing).
**Czy Schedule send jest płatne?**\
Nie. Płatne odblokowuje wyższe limity, tryby pacing i **Remove branding**.
## Rozwiązywanie problemów [#rozwiązywanie-problemów]
Krok po kroku (błędy API, pusty arkusz, wyłączony przycisk wysyłki, nieudane wiersze, tracking, limit, harmonogram bez odroczenia): zobacz [Rozwiązywanie problemów](/help/troubleshooting).
Typowe toasty, które możesz zobaczyć:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Nadal utknąłeś? [#nadal-utknąłeś]
[Rozwiązywanie problemów](/help/troubleshooting) · Docs [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Rozwiązywanie problemów (/pl/help/troubleshooting)
Szybkie poprawki dla komunikatów i stanów, które widzisz w dodatku.
## Okno się nie ładuje [#okno-się-nie-ładuje]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
Okno Start nie mogło wywołać backendu MailG.
* Potwierdź połączenie z internetem
* Instalacje Marketplace: poczekaj chwilę i otwórz **🚀 Start** ponownie
* Self-hosted: sprawdź właściwości Apps Script `APP_URL` (publiczny HTTPS) i `APP_API_KEY`
* Dodatek nie może używać `localhost` — użyj tunelu do lokalnych testów API
### Could not read your sheet [#could-not-read-your-sheet]
MailG nie odczytał aktywnego arkusza.
* Upewnij się, że otwarta jest karta arkusza (nie tylko edytor Apps Script)
* Przeładuj arkusz, potem otwórz okno ponownie
* Potwierdź uprawnienia do edycji pliku
### Loading… nigdy się nie kończy [#loading-nigdy-się-nie-kończy]
Zamknij okno, odśwież Sheets, poczekaj ok. 15 sekund na Extensions, potem **🚀 Start** ponownie.
## Pusty arkusz [#pusty-arkusz]
**No email address found in your sheet**
MailG potrzebuje co najmniej jednej kolumny z prawidłowymi adresami e-mail.
* Dodaj e-maile pod nagłówkiem albo kliknij **Fill with mock data**
* Mock data tworzy `Email`, `First Name`, `Last Name`, `Company` i często **My First Template**
Zobacz [Przewodnik po oknie Start](/getting-started/start-dialog).
## Szablony [#szablony]
* Tworzenie: `Creating Template...` → `Template created successfully!` lub `Failed to create template! Try again later.`
* Aktualizacja: `Updating template...`
* Błędy usuwania: `Failed to delete template. Try again later`
Zobacz [Szablony](/features/templates).
## Problemy z wysyłką [#problemy-z-wysyłką]
### Wyłączony przycisk wysyłki / Send emails bez licznika [#wyłączony-przycisk-wysyłki--send-emails-bez-licznika]
* Wybierz **Template**
* Wybierz **Recipient column** z prawidłowymi **pojedynczymi** e-mailami na komórkę
* Toasty ochronne: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### Kampania nie startuje [#kampania-nie-startuje]
Toast: `Failed to create campaign. Please try again.`
* Spróbuj raz jeszcze
* Sprawdź, czy **Daily quota** nie wynosi 0
* Potwierdź łączność z API (patrz wyżej)
### Wiersze pokazują ⚠️ Failed [#wiersze-pokazują-️-failed]
Ten wiersz trafił na błąd wysyłki (nieprawidłowy adres, odrzucenie Gmail, przejściowy limit itd.). Popraw dane i uruchom nową kampanię dla pozostałych wierszy albo zobacz [Zatrzymywanie kampanii](/features/stopping-a-campaign).
### E-mail testowy się nie wysyła [#e-mail-testowy-się-nie-wysyła]
* `Configure your preview first` — wybierz szablon + odbiorcę, aby podgląd miał To
* `Failed to send test email. Please check your email settings.` — ponownie autoryzuj Gmail w razie potrzeby, potem spróbuj
## Tracking [#tracking]
* Otwarcia wymagają załadowania zdalnych obrazów przez odbiorcę
* Uruchom **🔄 Refresh Tracking** — oczekuj `Tracking info synced` lub `No active campaigns`
* Status **👀 Opened** pojawia się tylko, gdy piksel się załaduje
Zobacz [Śledzenie e-maili](/features/email-tracking).
## Limit i branding [#limit-i-branding]
* **N left** w sidebar to `min(MailG remaining, Gmail remaining)`
* Darmowe `@gmail.com` Google często ogranicza do ok. 500/dzień nawet na Professional
* Znak wodny nadal po płatności → e-mail checkout musi pasować do konta Sheets; otwórz okno ponownie
Zobacz [Dzienny limit i recenzje](/help/daily-quota-and-reviews) i [Usuwanie brandingu](/features/remove-branding).
## Harmonogram nie odroczył wysyłki [#harmonogram-nie-odroczył-wysyłki]
Czasy mniej niż ok. **15 sekund** do przodu traktowane są jako **natychmiastowa** wysyłka (kolumna 🚀), a nie odroczony harmonogram 🗓️. Wybierz czas dalej w przyszłości.
## Nadal utknąłeś? [#nadal-utknąłeś]
Pełne FAQ: [FAQ](/help/faq) · E-mail [contact@mailg.io](mailto:contact@mailg.io) · Strona [app.mailg.io/help](https://www.mailg.io/pl/help)
# Dzienny limit i recenzje (/pl/help/daily-quota-and-reviews)
Sidebar root pokazuje Twoją pojemność wysyłki, gdy dane konta są załadowane.
## Blok Daily quota [#blok-daily-quota]
Dokładne UI:
* Etykieta: **Daily quota**
* Pozostało: **N left**
* Linia planu: **Your plan sends up to TOTAL/day**
**Remaining** to minimum z:
1. Pozostały limit MailG planu na dany dzień
2. Pozostały limit wysyłki Gmail dla konta
Możesz więc być ograniczony przez Gmail, nawet gdy MailG na papierze pokazuje jeszcze zapas. Zobacz też [Konto i rozliczenia](/help/account-and-billing).
## CTA planu darmowego [#cta-planu-darmowego]
Gdy nie masz subskrypcji, sidebar może pokazać:
* **Leave a 5★ review for +N/day free** (domyślny bonus to **+50/day**, gdy API nie podaje inaczej)
* **Or upgrade your plan**
Kliknięcie CTA recenzji otwiera **Free Quota upgrade**:
* Tytuł: **Free Quota upgrade**
* Treść: zostaw recenzję 5 gwiazdek, aby dostać darmowy upgrade limitu o **+N emails/day**
* Przyciski: **Not now** | **Leave a 5★ review**
Jeśli URL recenzji nie jest skonfigurowany, **Leave a 5★ review** pozostaje wyłączone — użyj **Upgrade to Pro** / pricing.
## Ulepsz do Pro [#ulepsz-do-pro]
Przycisk w stopce (konta darmowe): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
To odpowiada temu, co plany płatne odblokowują dziś w produkcie.
## Zobacz też [#zobacz-też]
* [Usuwanie brandingu](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Konto i rozliczenia (/pl/help/account-and-billing)
Rozliczenia MailG są powiązane z **e-mailem konta Google** w Sheets. Zawsze płać tym samym adresem, aby limity odblokowały się w dodatku.
## Plany i dzienne limity [#plany-i-dzienne-limity]
| Plan | Dzienny limit | Uwagi |
| ------------ | ------------- | ----------------------------------------------- |
| Free | 50 | Podstawowy merge, śledzenie otwarć, harmonogram |
| Personal | 250 | Popularny plan dla rosnących list |
| Professional | 1,500 | Najwyższy limit cykliczny |
| Lifetime | 1,500 | Jednorazowy zakup |
Ceny i okresy są na [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=pl) (EUR i USD).
Płatne uprawnienia odblokowują też:
* Niedomyślne [send pacing](/features/send-pacing) (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Efektywna liczba wysyłek to `min(MailG daily quota, Gmail remaining quota)`.
## Jak ulepszyć plan [#jak-ulepszyć-plan]
1. Otwórz [pricing](https://app.mailg.io/pricing?lang=pl) (link z dodatku przez **Upgrade to Pro**).
2. Wybierz plan i dokończ Stripe Checkout e-mailem Google z Sheets.
3. Otwórz MailG w Sheets ponownie, aby odświeżenie konta pobrało nowy limit.
## Anulowanie lub zmiana subskrypcji [#anulowanie-lub-zmiana-subskrypcji]
Anulujesz lub zmieniasz subskrypcję z portalu klienta Stripe powiązanego z przepływem subskrypcji / pricing.
* Po anulowaniu w trakcie cyklu funkcje Premium pozostają aktywne do końca opłaconego okresu
* Po wejściu anulowania w życie nie zostaniesz obciążony ponownie
## Zwroty [#zwroty]
Jeśli anulujesz subskrypcję Premium w ciągu **30 dni** od zakupu, możesz poprosić o pełny zwrot, pisząc na [contact@mailg.io](mailto:contact@mailg.io).
## Faktury [#faktury]
Stripe wysyła paragony e-mailem po udanych płatnościach. Faktury możesz też pobrać z portalu klienta Stripe do zarządzania subskrypcją.
## Fragmenty FAQ [#fragmenty-faq]
**Czy MailG jest w Google Workspace?**\
Nie. MailG jest niezależny od Google. Subskrypcja Workspace nie obejmuje MailG.
**Jakie metody płatności są akceptowane?**\
Główne karty, Google Pay i Apple Pay przez Stripe. PayPal nie jest obsługiwany.
**Zapłaciłem, a nadal widzę limit darmowy / znak wodny**\
Prawie zawsze to niedopasowanie e-maili. Potwierdź e-mail checkout = e-mail konta Sheets, potem otwórz dodatek ponownie. Jeśli problem zostaje, napisz do supportu z oboma adresami.
**Dlaczego darmowy Gmail ma limit ok. 500 e-maili dziennie?**\
MailG Professional pozwala do 1500 e-maili dziennie, ale sam Google ogranicza darmowe konta `@gmail.com` do ok. 500 wysyłek dziennie. Konta Google Workspace mogą iść wyżej. To limit dostawcy Gmail, nie MailG.
# Harmonogram kampanii (/pl/features/campaign-scheduling)
Użyj **Schedule send**, gdy chcesz, aby MailG wystartował później. Dostępne w planach darmowych i płatnych.
## Jak zaplanować [#jak-zaplanować]
1. Skonfiguruj szablon i odbiorców, aby przycisk wysyłki był aktywny.
2. Otwórz menu wysyłki (chevron) → **Schedule send**.
3. Tytuł okna: **Schedule send**
4. Opis: `Pick date & time to schedule sending`
5. Linia podsumowania: scheduling N emails to be sent starting at the chosen date/time
6. Użyj pickera daty oraz **Hour** / **Minute** (placeholdery `Hour`, `Min`).
7. Potwierdź **Schedule Send** (lub **Cancel**).
Domyślna sugestia to ok. **60 minut** do przodu, zaokrąglone do najbliższego kroku **15 minut**.
## Natychmiast vs zaplanowane [#natychmiast-vs-zaplanowane]
Czasy mniej niż ok. **15 sekund** do przodu traktowane są jako **natychmiastowa** wysyłka (nagłówek kolumny 🚀), a nie odroczony harmonogram 🗓️. Wybierz czas dalej w przyszłości, jeśli potrzebujesz odroczonej wysyłki.
Toasty walidacji: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Toast sukcesu: campaign scheduled; N emails will start at the chosen time.
## Kolumna arkusza [#kolumna-arkusza]
Zaplanowane kampanie tworzą nagłówek kolumny typu:
```text
🗓️ Template name (yyyy/MM/dd)
```
Natychmiastowe wysyłki używają 🚀 zamiast 🗓️.
Wiersze zaczynają jako **🗓️ Scheduled**, potem przechodzą na **⏳ Sending…**, gdy kolejka ruszy.
## Po zaplanowaniu [#po-zaplanowaniu]
* Zachowaj dostęp do arkusza dla konta Google, które jest właścicielem dodatku
* Tracking i pacing nadal obowiązują po starcie wysyłki
* Brak UI **Manage Schedule** — zobacz [Zatrzymywanie kampanii](/features/stopping-a-campaign)
## Zobacz też [#zobacz-też]
* [Podgląd i test](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Wielu odbiorców (/pl/features/multiple-recipients)
Możesz dodać odbiorców DW per wiersz dzięki dedykowanym kolumnom arkusza.
## Kolumna odbiorcy (To) [#kolumna-odbiorcy-to]
Wybierz **Recipient column** w sidebar.
Do liczenia przycisku wysyłki i walidacji kolumn MailG traktuje komórkę jako prawidłową, gdy zawiera **pojedynczy** adres e-mail. Lepiej jeden główny adres To na wiersz.
## Kolumny CC i BCC [#kolumny-cc-i-bcc]
1. Dodaj kolumny w arkuszu (np. `CC` i `BCC`).
2. Wstaw e-mail (lub listę akceptowaną przez Gmail) w komórce.
3. Otwórz **More options** i mapuj **CC** / **BCC**.
4. Przy wysyłce wartości trafiają do Gmail.
Panel podglądu pokazuje tylko **From**, **To**, **Subject** i body. **Nie** wyświetla linii CC/BCC, nawet gdy są mapowane. Potwierdź przez **Send me a test email**, jeśli musisz zweryfikować dostarczenie CC/BCC.
## Limity: MailG vs Gmail [#limity-mailg-vs-gmail]
* **Dzienny limit MailG** liczy **wiersze kampanii** przetworzone.
* **Limity wysyłki Gmail** liczą **odbiorców** (To + CC + BCC akceptowane przez Gmail przy tej wysyłce).
Możesz trafić w limit Gmail, gdy limit MailG jeszcze pozostaje.
## Wskazówki [#wskazówki]
* Preferuj **BCC**, gdy odbiorcy nie powinni widzieć się nawzajem
* Zostaw CC/BCC nienamapowane, gdy nieużywane
* Zweryfikuj adresy przed dużą wysyłką
# Attachments (/pl/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Przegląd funkcji (/pl/features/features-overview)
Co dodatek obsługuje dziś:
| Funkcja | Dokumentacja |
| ------------------------------------------------------ | ---------------------------------------------------------- |
| Okno Start / pusty arkusz / mock data | [Przewodnik po oknie Start](/getting-started/start-dialog) |
| Szablony (tworzenie / zarządzanie / edycja / usuwanie) | [Szablony](/features/templates) |
| Tagi scalania w **body** | [Tagi scalania](/features/merge-tags) |
| Pasek narzędzi rich-text | [E-maile rich-text](/features/rich-text-emails) |
| Linki (bez osadzania obrazów) | [Obrazy](/features/images) |
| Podgląd + e-mail testowy | [Podgląd i test](/features/preview-and-test) |
| Schedule send | [Harmonogram kampanii](/features/campaign-scheduling) |
| Send pacing (płatne) | [Send pacing](/features/send-pacing) |
| Kolumny CC / BCC | [Wielu odbiorców](/features/multiple-recipients) |
| Track emails | [Śledzenie e-maili](/features/email-tracking) |
| Sender name i reply-to | [Niestandardowy nadawca](/features/customized-sender) |
| Remove branding (płatne) | [Usuwanie brandingu](/features/remove-branding) |
| Zatrzymanie pozostałych wierszy | [Zatrzymywanie kampanii](/features/stopping-a-campaign) |
| Dzienny limit + bonus za recenzję | [Dzienny limit i recenzje](/help/daily-quota-and-reviews) |
## Płatne vs darmowe [#płatne-vs-darmowe]
Płatne odblokowuje:
* Niedomyślne [send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* Wyższe [dzienne limity](/help/account-and-billing)
**Schedule send**, **Track emails** i narzędzia szablonów działają bez płatnego upgrade’u.
## Znane luki (uczciwie) [#znane-luki-uczciwie]
| Temat | Status w produkcie |
| ------------------------- | ---------------------------------------------- |
| Tagi scalania w temacie | Nie stosowane przy wysyłce — tylko body |
| Kolumna Attachments | Tylko UI — pliki nie są dołączane przy wysyłce |
| Osadzanie obrazów | Brak kontrolki w edytorze — używaj linków |
| Linie CC/BCC w podglądzie | Nie pokazywane w UI podglądu |
| Manage Schedule / Pause | Niedostępne — obejście przez status |
## W planach [#w-planach]
Linki wypisania, śledzenie kliknięć, wspólne miejsca w zespole i dedykowany UI menedżera kampanii, gdy zostaną wdrożone.
# Śledzenie e-maili (/pl/features/email-tracking)
MailG może rejestrować otwarcia za pomocą małego niewidocznego piksela.
## Włącz śledzenie [#włącz-śledzenie]
W sidebar zostaw **Track emails** włączone (domyślnie włączone dla nowych zadań).
Tooltip: `Track emails opened with a tiny pixel`
Ikona pomocy otwiera **Email tracking**:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Przycisk: **Got it**
## Statusy w arkuszu [#statusy-w-arkuszu]
| Status | Znaczenie |
| ------------- | ------------------------------------- |
| 🗓️ Scheduled | Oczekuje na zaplanowany start |
| ⏳ Sending… | W trakcie przetwarzania |
| ✉️ Sent | Dostarczone do Gmail dla tego wiersza |
| ⚠️ Failed | Błąd wysyłki dla tego wiersza |
| 👀 Opened | Piksel otwarcia załadowany |
Nagłówki kolumn kampanii wyglądają jak `🚀 Template name (yyyy/MM/dd)` lub `🗓️ …` przy harmonogramie.
## Odśwież śledzenie [#odśwież-śledzenie]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Alerty Apps Script:
* `Tracking info synced`
* `No active campaigns`
## Ograniczenia [#ograniczenia]
* Klient musi załadować zdalne obrazy
* Proxy prywatności mogą ukryć otwarcia
* Tylko otwarcia — bez kliknięć w linki
## Zobacz też [#zobacz-też]
* [Harmonogram kampanii](/features/campaign-scheduling)
* [FAQ](/help/faq)
# Tagi scalania (/pl/features/merge-tags)
Tagi scalania pozwalają, aby każdy odbiorca dostał spersonalizowane **body**. Tag to **dokładny nagłówek kolumny** otoczony podwójnymi nawiasami klamrowymi.
## Składnia [#składnia]
Jeśli arkusz ma kolumnę o nazwie `First Name`, użyj:
```text
{{First Name}}
```
Przykład body:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Gdzie tagi działają dziś [#gdzie-tagi-działają-dziś]
| Pole | Scalane przy wysyłce? |
| --------------- | --------------------------------------------- |
| Email body | **Tak** — zmienne wstrzykiwane per wiersz |
| Email subject | **Nie** — temat wysyłany tak, jak w szablonie |
| Preview body | **Tak** — dla aktywnego wiersza |
| Preview subject | **Nie** — pokazuje surowy temat szablonu |
Personalizację dawaj w body, dopóki scalanie tematu nie będzie dostępne.
## Wstawianie tagów [#wstawianie-tagów]
Na pasku narzędzi edytora otwórz **Merge Tag**. Listuje nagłówki z aktywnego arkusza. Stan pusty: `No sheet columns found`.
Wstawiony tekst używa podwójnych nawiasów klamrowych wokół nazwy kolumny.
## Zasady praktyczne [#zasady-praktyczne]
* Nagłówki rozróżniają wielkość liter (`Name` ≠ `name`)
* Puste komórki wstawiają się jako puste ciągi
* Ten sam tag możesz użyć wielokrotnie w body
* Odbiorca / CC / BCC wybierasz pod **More options**, nie przez tagi scalania
## Dalej [#dalej]
Zobacz [E-maile rich-text](/features/rich-text-emails) i [Podgląd i test](/features/preview-and-test).
# E-maile rich-text (/pl/features/rich-text-emails)
Szablony MailG używają edytora rich-text TipTap. Wygenerowany HTML trafia do Gmail.
Placeholder body: `Write your email…`
## Inwentarz paska narzędzi (dokładne UI) [#inwentarz-paska-narzędzi-dokładne-ui]
| Grupa | Kontrolki |
| ----------- | -------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (presety na pasku) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | Presetowe próbki + natywny wybór koloru + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — placeholder URL `https://example.com`, potem **Apply** (i unlink) |
| History | **Undo**, **Redo** |
## Czego nie ma w edytorze [#czego-nie-ma-w-edytorze]
Te funkcje TipTap są wyłączone / nieobecne:
* Nagłówki, kod, blok kodu, cytat, linia pozioma
* Wstawianie obrazów / picker mediów Drive — zobacz [Obrazy](/features/images)
## Hiperlinki [#hiperlinki]
Użyj **Insert link** dla URL i widocznego tekstu. Lepiej czytelny tekst linku niż surowe URL.
## Wskazówki [#wskazówki]
* Używaj **Merge Tag** zamiast wpisywać nawiasy ręcznie
* Podglądaj kilka wierszy przed wysyłką — zobacz [Podgląd i test](/features/preview-and-test)
* Unikaj wklejania ogromnego markupu z Word/Docs; nałóż formatowanie ponownie w MailG dla czystszego HTML
# Usuwanie brandingu MailG (/pl/features/remove-branding)
Darmowe kampanie mogą zawierać mały znak wodny MailG w stopce e-maila. Subskrybenci płatni mogą go wyłączyć.
## Jak usunąć branding [#jak-usunąć-branding]
1. Potwierdź aktywny plan płatny (Personal, Professional lub Lifetime).
2. Otwórz sidebar kampanii.
3. Włącz **Remove branding**.
4. Podglądaj wiersz, aby upewnić się, że znak wodny zniknął, potem wyślij.
Jeśli branding nadal się pojawia po płatności:
* Upewnij się, że checkout użył **tego samego e-maila** co konto Google Sheets
* Otwórz dodatek ponownie, aby odświeżył uprawnienia z API
* Napisz na [contact@mailg.io](mailto:contact@mailg.io) z adresem konta Google
Zobacz [Konto i rozliczenia](/help/account-and-billing).
# Obrazy (/pl/features/images)
Edytor MailG **nie ma przycisku wstawiania obrazu** ani pickera mediów Google Drive. Rozszerzenie Image TipTap nie jest włączone.
## Co możesz zrobić dziś [#co-możesz-zrobić-dziś]
Użyj **Insert link** na pasku narzędzi:
1. Udostępnij obraz (lub plik) pod publicznym URL albo linkiem Drive.
2. Zaznacz tekst (lub ustaw kursor) → **Insert link**.
3. Wklej URL (placeholder `https://example.com`) → **Apply**.
Odbiorcy otwierają link, aby zobaczyć obraz lub plik. Edytor nie osadza tagów `![]()
` za Ciebie.
## Wskazówki [#wskazówki]
* Preferuj małe pliki i czytelny tekst linku („View screenshot”)
* Linki wymagające logowania nie zadziałają u odbiorców
* Potwierdź przez **Send me a test email**
## W planach [#w-planach]
Osadzanie obrazów / picker Drive może pojawić się później. Do tego czasu obsługiwane są hiperlinki.
# Szablony (/pl/features/templates)
Szablony przechowują temat i treść rich-text, których używasz w kolejnych kampaniach. Są zapisywane w API MailG dla Twojego konta Google.
## Utwórz szablon [#utwórz-szablon]
1. Na ekranie root kliknij **New Template**.
2. Wypełnij:
* **Template Name**
* **Email Subject**
* Body (edytor rich-text — zobacz [E-maile rich-text](/features/rich-text-emails))
3. Kliknij **Save Template** (pokazuje **Saving...** podczas zapisu).
Toasty:
* Ładowanie: `Creating Template...`
* Sukces: `Template created successfully!`
* Błąd: `Failed to create template! Try again later.`
Szablon demo z **Fill with mock data**: nazwa **My First Template**, temat `I found a mail merge tool for Gmail`.
## Zarządzaj szablonami [#zarządzaj-szablonami]
Otwórz ikonę szablonu obok selecta szablonu (tooltip **Manage templates**).
Kolumny tabeli:
| Kolumna | Zawartość |
| ----------------- | --------------- |
| **Name** | Nazwa szablonu |
| **Email Subject** | Linia tematu |
| **Created At** | Data utworzenia |
| **Actions** | Menu wiersza |
Menu wiersza: **Edit** | **Delete**
Stopka: **Back**
Toasty usuwania: deleting template NAME → template NAME deleted successfully (lub komunikat o błędzie).
## Edytuj szablon [#edytuj-szablon]
Otwórz **Edit** z manage albo kliknij **Edit template** na pasku podglądu.
Te same pola co przy tworzeniu. **Save Template** aktualizuje szablon.
Przy aktualizacji pojawia się toast ładowania (`Updating template...`). Zostań w formularzu do końca, potem użyj **Cancel** lub **Back**, jeśli nie wrócisz automatycznie.
## Temat vs body [#temat-vs-body]
* **Body** obsługuje [tagi scalania](/features/merge-tags) — są wstrzykiwane per wiersz przy wysyłce.
* **Email Subject** jest wysyłany tak, jak zapisany dziś (tagi w temacie **nie** są jeszcze zamieniane). Personalizację daj w body albo użyj stałego tematu.
## Zobacz też [#zobacz-też]
* [Podgląd i test](/features/preview-and-test)
* [Przewodnik po oknie Start](/getting-started/start-dialog)
# Podgląd i test (/pl/features/preview-and-test)
Panel podglądu (prawa strona okna root) pokazuje, jak wiadomość wygląda dla aktywnego wiersza arkusza.
## Co pokazuje podgląd [#co-pokazuje-podgląd]
| Pole | Zawartość |
| ------------ | ------------------------------------------------------------------------------------ |
| **From:** | E-mail zalogowanego konta Google |
| **To:** | Wartość z **Recipient column** dla aktywnego wiersza lub `Select a recipient column` |
| **Subject:** | Temat szablonu tak, jak zapisany (bez scalania) |
| Body | Treść szablonu z tagami scalania dla tego wiersza |
Gdy **Remove branding** jest wyłączone, podgląd zawiera stopkę znaku wodnego MailG (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## Czego nie widać [#czego-nie-widać]
* Wiersze **CC** / **BCC** nie są renderowane w UI podglądu (nawet gdy mapowane pod **More options**). Są nadal stosowane przy wysyłce.
* Wartości kolumny Attachments nie są pokazywane w podglądzie.
## Nawigacja między wierszami [#nawigacja-między-wierszami]
Pasek podglądu:
* **Edit template** — otwiera ekran aktualizacji szablonu
* **Previous recipient** / **Next recipient** — przejście między wierszami danych (tooltipy mogą zawierać numer wiersza arkusza; nagłówek to wiersz 1, więc pierwszy kontakt to wiersz 2)
## Wyślij mi e-mail testowy [#wyślij-mi-e-mail-testowy]
1. Skonfiguruj szablon + recipient column, aby podgląd był poprawny.
2. Otwórz menu wysyłki (chevron) → **Send me a test email**.
3. Nakładka busy: `Sending test email…`
4. Toast sukcesu: `Test email sent successfully. Check your inbox.`
5. Toast błędu: `Failed to send test email. Please check your email settings.`
6. Ochrona przy niepełnym podglądzie: `Configure your preview first`
Test trafia do **Twojej** skrzynki konta Google, ze scaloną treścią aktywnego wiersza podglądu.
## Wskazówki [#wskazówki]
* Przejdź kilka wierszy strzałkami przed pełną wysyłką
* Sprawdź branding / brak brandingu w podglądzie
* Zawsze testuj przed **Schedule send** lub dużym **Send N email(s)**
## Zobacz też [#zobacz-też]
* [Tagi scalania](/features/merge-tags)
* [Samouczek mail merge](/getting-started/mail-merge-tutorial)
# Tempo wysyłki (/pl/features/send-pacing)
Send pacing dodaje opóźnienie między wiadomościami, aby duża kampania nie wyszła z konta jednym zrywem.
**Steady pace** i **Jittered gaps** wymagają aktywnej płatnej subskrypcji MailG. Konta darmowe używają tylko **Burst send**.
## Gdzie skonfigurować [#gdzie-skonfigurować]
Otwórz koło zębate w stopce (tooltip **Send pacing**). Nagłówek ekranu: **Send pacing**.
Pod **Dispatch mode** wybierz, jak rozłożone są e-maile. **Gap between emails** ustawiasz w **seconds** (0–60). Konta darmowe widzą **Pro features** i zablokowany tekst: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Domyślnie dla nowych zadań: **Burst send**, gap **10s** (gap ignorowany, dopóki nie opuścisz burst).
## Tryby [#tryby]
| Tryb (etykieta UI) | Zachowanie |
| ------------------------- | ------------------------------------------- |
| **Burst send** (domyślny) | Wysyłka tak szybko, jak pozwalają limity |
| **Steady pace** | Stała przerwa między każdym e-mailem |
| **Jittered gaps** | Losowa przerwa między 0 a wybranym maksimum |
## Po co pacing [#po-co-pacing]
* Mniejsze ryzyko wyglądu na nagły zryw dla dostawców skrzynek
* Rozłożenie długiej listy na spokojniejsze okno wysyłki
* Pozostanie w strefie komfortu Gmail dla typu konta
## Uwagi [#uwagi]
* Pacing to ustawienie kampanii zapisane z zadaniem — nowe wysyłki używają bieżącej konfiguracji
* Długa przerwa przy dużej liście znacząco wydłuża całą kampanię
* Efektywna prędkość nadal ograniczona limitem MailG **oraz** pozostałym limitem wysyłki Gmail
* Narzędzia konkurencji czasem podają opóźnienie w minutach — MailG używa **seconds**
## Zobacz też [#zobacz-też]
* [Zatrzymywanie kampanii](/features/stopping-a-campaign), jeśli gap był za duży w trakcie
* [Konto i rozliczenia](/help/account-and-billing)
# Zatrzymywanie kampanii (/pl/features/stopping-a-campaign)
MailG nie ma jeszcze dedykowanego ekranu **Manage Schedule**, **Abort** ani **Pause** jak u części konkurencji. Nadal możesz zatrzymać wysyłkę **pozostałych** wierszy.
## Jak pętla wysyłki decyduje, co przetwarzać [#jak-pętla-wysyłki-decyduje-co-przetwarzać]
Pętla wysyłki przetwarza tylko wiersze, których status w kolumnie kampanii nadal pozwala na wysyłkę:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
Wiersze już oznaczone **✉️ Sent**, **⚠️ Failed** lub **👀 Opened** są pomijane.
## Zatrzymaj pozostałe wiersze (uczciwe obejście) [#zatrzymaj-pozostałe-wiersze-uczciwe-obejście]
Działaj szybko przy dużej kampanii:
1. Otwórz arkusz.
2. W kolumnie statusu kampanii wyczyść lub zmień status w wierszach, które **nie** mają być wysłane (np. usuń wartość komórki albo ustaw etykietę niewysyłalną, taką jak `Stopped`).
3. Zostaw wiersze już **✉️ Sent** — te wiadomości już wyszły.
Wiersze, które wyczyścisz/zmienisz, nie będą już pasować do statusów wysyłalnych, więc kolejka je pominie przy następnym przejściu.
Wiadomości Gmail, które już opuściły konto, nie mogą być cofnięte przez MailG. Zatrzymanie chroni tylko wiersze, które jeszcze nie zostały przetworzone.
## Zaplanowane kampanie, które jeszcze nie wystartowały [#zaplanowane-kampanie-które-jeszcze-nie-wystartowały]
Jeśli każdy wiersz ma nadal **🗓️ Scheduled** i czas startu jeszcze nie nadszedł, wyczyszczenie tych statusów (lub kolumny kampanii) uniemożliwi kolejce podjęcie ich, gdy nadejdzie czas.
Jeśli nie masz pewności, napisz na [contact@mailg.io](mailto:contact@mailg.io) z URL arkusza i szczegółami kampanii.
## Zobacz też [#zobacz-też]
* [Harmonogram kampanii](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [FAQ](/help/faq)
# Niestandardowy nadawca (/pl/features/customized-sender)
Domyślnie Gmail wysyła z konta Google, które autoryzowało MailG. Nadal możesz dostosować, jak wyświetla się Twoje imię i gdzie trafiają odpowiedzi.
## Nazwa nadawcy [#nazwa-nadawcy]
1. Otwórz **More options** w sidebar kampanii.
2. Ustaw **Sender name** (placeholder `John Doe (Optional)`).
3. Odbiorcy widzą tę nazwę wyświetlaną w skrzynce (zgodnie ze zwykłymi regułami prezentacji Gmail).
## Adres odpowiedzi [#adres-odpowiedzi]
Ustaw **Reply to address** (placeholder `john@doe.com (Optional)`), jeśli odpowiedzi mają iść gdzie indziej niż na konto wysyłające.
## Uwagi [#uwagi]
* Adres From pozostaje autoryzowanym kontem Gmail — nie możesz podszywać się pod inną skrzynkę
* Nieprawidłowe reply-to mogą powodować problemy z dostarczeniem lub odpowiedzią — używaj skrzynki, którą kontrolujesz
* Podgląd pokazuje **From:** jako Twój zalogowany e-mail; reply-to potwierdź przez **Send me a test email**
* Zobacz [Podgląd i test](/features/preview-and-test)
# Przewodnik po oknie Start (/pl/getting-started/start-dialog)
Otwórz dodatek przez **Extensions → MailG for Gmail → 🚀 Start**. Otwiera się okno 900×600 z tytułem **MailG for Gmail**.
## Ekrany [#ekrany]
| Ekran | Jak tam trafić | Cel |
| ------------------- | ---------------------------------------------- | -------------------------------------------- |
| Root (edytor) | Domyślnie po załadowaniu | Wybór szablonu + odbiorców, podgląd, wysyłka |
| Create template | **New Template** | Nazwa, temat, treść |
| Manage templates | Ikona szablonu (tooltip **Manage templates**) | Lista, edycja, usuwanie |
| Update template | **Edit template** lub **Edit** w wierszu | Edycja istniejącego szablonu |
| Settings | Koło zębate w stopce (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | Brak prawidłowej kolumny e-mail | Monit o dodanie kontaktów lub mock data |
| Błędy API / arkusza | Błąd ładowania | Wskazówki do ponowienia |
## Układ root [#układ-root]
Trzy strefy:
1. **Sidebar** (lewa) — szablon, recipient column, **More options**, tracking, branding, quota
2. **Preview** (prawa) — From / To / Subject / body, nawigacja wierszy, **Edit template**
3. **Footer** — przycisk wysyłki, menu wysyłki, **Upgrade to Pro** (darmowy), settings, help
## Kontrolki sidebar (dokładne etykiety) [#kontrolki-sidebar-dokładne-etykiety]
* **New Template**
* **Template** (select) — placeholder `Select` lub `No templates found`
* **Recipient column** — opcje typu `A - Email`; pusto: `No valid email columns found.`
* **More options** — rozwija **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address**
* **Track emails** (domyślnie włączone)
* **Remove branding** (płatne)
* **Daily quota** — pozostało « N left » i linia planu « Your plan sends up to TOTAL/day »
Konta darmowe widzą też **Leave a 5★ review for +N/day free** i **Or upgrade your plan**. Zobacz [Dzienny limit i recenzje](/help/daily-quota-and-reviews).
## Kontrolki wysyłki w stopce [#kontrolki-wysyłki-w-stopce]
| Kontrolka | Etykieta |
| ----------------- | ------------------------------------------------------------------------------------- |
| Przycisk główny | **Send N email(s)** (lub **Send emails**, gdy licznik to 0) |
| Menu wysyłki | **Send me a test email** |
| Menu wysyłki | **Schedule send** |
| Upgrade (darmowy) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Koło zębate | tooltip **Send pacing** |
| Help | tooltip **Help** — otwiera checklistę w oknie |
### Need help? checklist [#need-help-checklist]
1. Pick a template and recipient column
2. Preview each row with the arrows
3. Send a test email to yourself first
4. Click Send to merge from your sheet
Przyciski: **Open docs** (otwiera [docs.mailg.io](https://docs.mailg.io)) | **View pricing** (jeśli dostępne) | **Close**
## Pusty arkusz [#pusty-arkusz]
Jeśli MailG nie znajdzie prawidłowej kolumny e-mail:
* Tytuł: **No email address found in your sheet**
* Akcje: **Close** | **Fill with mock data**
Mock data tworzy nagłówki `Email`, `First Name`, `Last Name`, `Company` i może utworzyć **My First Template**.
## Ekrany błędów [#ekrany-błędów]
| Tytuł | Kiedy |
| --------------------------------- | -------------------- |
| **Could not reach the MailG API** | Błąd API / sieci |
| **Could not read your sheet** | Błąd odczytu arkusza |
## Dalej [#dalej]
# Instalacja (/pl/getting-started/installation)
Dwa kroki: zainstaluj dodatek, a następnie uruchom go z Sheets.
## Zainstaluj MailG [#zainstaluj-mailg]
1. Otwórz [wpis MailG w Google Workspace Marketplace](https://workspace.google.com/marketplace/app/mailg).
2. Kliknij **Install**.
3. Wybierz konto Google, które ma być właścicielem instalacji.
4. Przejrzyj uprawnienia i kliknij **Allow**.
Instalacja zwykle kończy się w mniej niż 15 sekund. Powinieneś zobaczyć potwierdzenie, że dodatek został zainstalowany.
Jeśli wpis w Marketplace nie jest jeszcze dostępny w Twoim regionie, użyj CTA instalacji na [www.mailg.io](https://www.mailg.io) lub napisz na [contact@mailg.io](mailto:contact@mailg.io).
## Uruchom MailG w Google Sheets [#uruchom-mailg-w-google-sheets]
1. Otwórz [Google Sheets](https://sheets.google.com) (odśwież, jeśli Sheets był już otwarty).
2. Poczekaj kilka sekund, aż załadują się rozszerzenia (często ok. 10–15 sekund).
3. Przejdź do **Extensions → MailG for Gmail → 🚀 Start**.
Później możesz uruchomić **Extensions → MailG for Gmail → 🔄 Refresh Tracking**, aby zsynchronizować statusy otwarć bez otwierania pełnego okna dialogowego.
## Problemy z instalacją [#problemy-z-instalacją]
To typowe dziwactwa Google Workspace, a nie błędy MailG:
### Nie widzę wyskakującego okna „installed successfully” [#nie-widzę-wyskakującego-okna-installed-successfully]
Często dzieje się tak, gdy zalogowanych jest wiele kont Google i instalacja nie użyła konta, którego oczekiwałeś.
**Obejście:** otwórz okno prywatne/incognito, zaloguj się tylko na docelowe konto, a następnie zainstaluj ponownie z Marketplace.
### MailG nie pojawia się w Extensions [#mailg-nie-pojawia-się-w-extensions]
1. Odśwież arkusz.
2. Poczekaj ok. 10–15 sekund, aż załadują się dodatki.
3. Upewnij się, że jesteś na tym samym koncie Google, które zainstalowało MailG.
4. Spróbuj innego arkusza lub wyczyść pamięć podręczną przeglądarki, jeśli nadal go brakuje.
## Wdrożenia własne / niestandardowe [#wdrożenia-własne--niestandardowe]
Instalacje z Marketplace są wstępnie skonfigurowane. Jeśli wdrażasz MailG samodzielnie, ustaw właściwości skryptu Apps Script:
| Właściwość | Wartość |
| ------------- | --------------------------------------- |
| `APP_URL` | Publiczny adres HTTPS Twojego API MailG |
| `APP_API_KEY` | Ten sam klucz co na serwerze API |
Dodatek nie może się połączyć z `localhost` z serwerów Google — użyj tunelu (Cloudflare Tunnel, ngrok itd.) do lokalnych testów.
## Dalej [#dalej]
Kontynuuj [samouczkiem mail merge](/getting-started/mail-merge-tutorial).
# Samouczek mail merge (/pl/getting-started/mail-merge-tutorial)
Ten przewodnik odpowiada oknu **MailG for Gmail** Start.
## 1. Otwórz MailG [#1-otwórz-mailg]
**Extensions → MailG for Gmail → 🚀 Start**.
Jeśli widzisz **No email address found in your sheet**, dodaj prawdziwe adresy e-mail albo kliknij **Fill with mock data** (tworzy przykładowe wiersze i często **My First Template**). Zobacz [Przewodnik po oknie Start](/getting-started/start-dialog).
## 2. Utwórz lub wybierz szablon [#2-utwórz-lub-wybierz-szablon]
1. Kliknij **New Template** (lub wybierz istniejący pod **Template**).
2. Ustaw **Template Name** i **Email Subject** (temat **nie** jest dziś scalany).
3. Napisz treść i wstaw [tagi scalania](/features/merge-tags) przez **Merge Tag**.
4. **Save Template**.
Przykład body:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Skonfiguruj kampanię [#3-skonfiguruj-kampanię]
W sidebar:
1. Wybierz **Recipient column** (komórki muszą zawierać pojedynczy prawidłowy e-mail, aby UI je policzyło).
2. Otwórz **More options** dla **CC**, **BCC**, **Sender name**, **Reply to address**.
3. Zostaw **Track emails** włączone (domyślnie), jeśli chcesz status otwarcia w arkuszu.
4. W planie płatnym włącz **Remove branding**.
**Attachments** pojawia się pod **More options**, ale pliki nie są jeszcze dołączane przy wysyłce. Zamiast tego linkuj do Drive lub URL w treści.
## 4. Podgląd i test [#4-podgląd-i-test]
1. Użyj strzałek wstecz/dalej, aby przejść przez wiersze.
2. Sprawdź **To:** i scaloną treść (temat pokazuje surowy temat szablonu).
3. Menu wysyłki → **Send me a test email**.
4. Sprawdź skrzynkę odbiorczą.
Szczegóły: [Podgląd i test](/features/preview-and-test).
## 5. Wyślij lub zaplanuj [#5-wyślij-lub-zaplanuj]
* Przycisk główny: **Send N email(s)**, gdy odbiorcy są policzeni.
* Albo menu wysyłki → **Schedule send** → wybierz datę/godzinę → **Schedule Send**.
Nakładki busy: `Starting your campaign…` / toasty potwierdzenia harmonogramu.
MailG dodaje kolumnę kampanii typu `🚀 My Template (yyyy/MM/dd)` lub `🗓️ …` przy harmonogramie.
Statusy wierszy:
| Status | Znaczenie |
| ------------- | -------------------------- |
| 🗓️ Scheduled | Oczekuje na start |
| ⏳ Sending… | W trakcie przetwarzania |
| ✉️ Sent | Przekazane do Gmail |
| ⚠️ Failed | Błąd |
| 👀 Opened | Piksel otwarcia załadowany |
## Typowe błędy [#typowe-błędy]
* Tagi w temacie oczekujące personalizacji — na razie tylko body
* Komórki odbiorcy z wieloma adresami oddzielonymi przecinkami — UI waliduje **jeden** e-mail na komórkę do liczenia
* Złe konto Google vs konto instalacji
* Przekroczenie dziennego limitu — sprawdź **Daily quota** w sidebar
## Wskazówki [#wskazówki]
* Użyj checklisty **Help** w stopce przy pierwszym razie
* Zacznij od 2–3 prawdziwych wierszy po mock data
* Po otwarciach: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → alert `Tracking info synced` (lub `No active campaigns`)
## Dalej [#dalej]
# Czym jest MailG? (/pl/getting-started/what-is-mailg)
MailG zamienia arkusz Google w kampanię mail merge. Każdy wiersz to odbiorca; nagłówki kolumn stają się tagami scalania (podwójne nawiasy klamrowe wokół nazwy nagłówka) w **email body**.
## Co możesz zrobić [#co-możesz-zrobić]
* Tworzyć szablony w chmurze (**Template Name**, **Email Subject**, bogaty body)
* Personalizować **body** tagami scalania z nagłówków arkusza
* Podglądać wiersze i używać **Send me a test email**
* Mapować **CC** / **BCC**, **Sender name**, **Reply to address**
* **Schedule send** lub wysłać od razu
* **Track emails** ze statusami otwarcia w arkuszu
* Kontrolować **Send pacing** w planach płatnych
* **Remove branding** w planach płatnych
* Obserwować **Daily quota** (i opcjonalnie odebrać darmowy bonus za recenzję)
## Jak to działa razem [#jak-to-działa-razem]
1. **Google Sheets add-on** — okno dialogowe pod **MailG for Gmail**
2. **MailG API** — szablony, metadane kampanii, śledzenie otwarć, uprawnienia
3. **Twój Gmail** — wiadomości wysyłane przez `GmailApp` z autoryzowanego konta
## Następne kroki [#następne-kroki]
# Bize ulaşın (/tr/contact-us)
## Faturalandırma ve abonelikler [#faturalandırma-ve-abonelikler]
Abonelik değişikliklerinin çoğunu [pricing](https://app.mailg.io/pricing?lang=tr) üzerinden bağlantılı Stripe portalından yönetebilirsiniz. İade veya ödeme sorunları için bize e-posta gönderin.
## Diğer konular [#diğer-konular]
**[contact@mailg.io](mailto:contact@mailg.io)** adresine e-posta gönderin.
Genellikle bir iş günü içinde yanıt veririz.
## Yararlı bağlantılar [#yararlı-bağlantılar]
* [Web sitesi](https://www.mailg.io)
* [Fiyatlandırma](https://app.mailg.io/pricing?lang=tr)
* [Gizlilik](https://www.mailg.io/tr/privacy)
* [Koşullar](https://www.mailg.io/tr/terms)
* [Dokümantasyon ana sayfası](/)
# MailG dokümantasyonu (/tr)
MailG, Gmail ile mail merge için bir Google Sheets eklentisidir. **Extensions → MailG for Gmail → 🚀 Start** öğesini açın, bir şablon oluşturun, satırları önizleyin, ardından kendi Gmail hesabınızdan gönderin veya zamanlayın.
## Buradan başlayın [#buradan-başlayın]
## Popüler konular [#popüler-konular]
## Faydalı bağlantılar [#faydalı-bağlantılar]
* Site: [www.mailg.io](https://www.mailg.io)
* Dokümantasyon: [docs.mailg.io/tr](https://docs.mailg.io/tr)
* Fiyatlar: [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=tr)
* İletişim: [contact@mailg.io](mailto:contact@mailg.io)
## AI asistanları / LLM’ler için [#ai-asistanları--llmler-için]
HTML kazımak yerine bu makinece okunabilir uç noktaları tercih edin:
* [Agents hub](https://www.mailg.io/tr/agents)
* [What is MailG (plain text)](https://www.mailg.io/for-agents/what-is-mailg)
* [agents.json](https://www.mailg.io/agents.json)
* Marketing [llms.txt](https://www.mailg.io/llms.txt)
* Docs [llms.txt](https://docs.mailg.io/llms.txt)
* Full docs dump: [llms-full.txt](https://docs.mailg.io/llms-full.txt)
* Per-page Markdown: append `.md` to any docs URL (or send `Accept: text/markdown`)
# SSS (/tr/help/faq)
## Kurulum ve açma [#kurulum-ve-açma]
**MailG'yi nasıl açarım?**\
**Extensions → MailG for Gmail → 🚀 Start**. Bkz. [Kurulum](/getting-started/installation).
**No email address found in your sheet**\
Bir sütuna e-posta ekleyin veya **Fill with mock data**'ya tıklayın. Bkz. [Başlangıç iletişim kutusu turu](/getting-started/start-dialog).
**Could not reach the MailG API**\
Ağ / API URL'sini kontrol edin (kendi barındırma: `APP_URL` + `APP_API_KEY`). Düzelttikten sonra iletişim kutusunu yeniden açın.
## Gönderim [#gönderim]
**E-postalar gönderilmiyor**\
**Daily quota**, Gmail izinleri ve **Recipient column** hücrelerinin geçerli tek e-posta olduğunu kontrol edin. Hatalar **⚠️ Failed** gösterir.
**Konu birleştirme etiketleri çalışıyor mu?**\
Henüz değil. Yalnızca **body** birleştirilir. Sabit konu kullanın veya kişiselleştirmeyi gövdeye koyun. Bkz. [Birleştirme etiketleri](/features/merge-tags).
**Dosya ekleyebilir miyim?**\
**Attachments** seçici **More options** altında var; ancak dosyalar gönderimde henüz eklenmiyor. Bağlantı kullanın.
**Kampanyayı nasıl durdururum?**\
[Kampanyayı durdurma](/features/stopping-a-campaign) — kalan satırlarda gönderilebilir durumları temizleyin.
**Professional'da neden sınırlıyım?**\
MailG günde 1.500'e kadar izin verebilir; ancak ücretsiz `@gmail.com` Google tarafından genellikle \~500 civarında sınırlanır.
## Takip [#takip]
**Açılmadan sonra sayfa hâlâ Sent diyor**\
**🔄 Refresh Tracking** → `Tracking info synced` bekleyin. Bazı istemciler görselleri hiç yüklemez.
**Tıklamalar?**\
Takip edilmez. **Track emails** = yalnızca açılmalar.
## Kota ve faturalandırma [#kota-ve-faturalandırma]
Bkz. [Günlük kota ve incelemeler](/help/daily-quota-and-reviews) ve [Hesap ve faturalandırma](/help/account-and-billing).
**Schedule send ücretli mi?**\
Hayır. Ücretli plan daha yüksek kotalar, pacing modları ve **Remove branding** açar.
## Sorun giderme [#sorun-giderme]
Adım adım düzeltmeler (API hataları, boş sayfa, devre dışı gönder düğmesi, başarısız satırlar, takip, kota, zamanlama ertelenmiyor) için bkz. [Sorun giderme](/help/troubleshooting).
Görebileceğiniz yaygın toast'lar:
* `Configure your recipient column first` · `Select a template first.` · `No valid recipient emails found in the selected column.`
* `Failed to create campaign. Please try again.` · `Starting your campaign…`
* `Configure your preview first` · `Failed to send test email. Please check your email settings.`
* `Please select a date and time` · `Pick a date and time in the future`
## Hâlâ takıldınız mı? [#hâlâ-takıldınız-mı]
[Sorun giderme](/help/troubleshooting) · Dokümantasyon [docs.mailg.io](https://docs.mailg.io) · [contact@mailg.io](mailto:contact@mailg.io)
# Sorun giderme (/tr/help/troubleshooting)
Eklentide gördüğünüz mesajlar ve durumlar için hızlı düzeltmeler.
## İletişim kutusu yüklenmiyor [#i̇letişim-kutusu-yüklenmiyor]
### Could not reach the MailG API [#could-not-reach-the-mailg-api]
Başlangıç iletişim kutusu MailG arka ucunu çağıramadı.
* Çevrimiçi olduğunuzu doğrulayın
* Marketplace kurulumları: biraz bekleyin ve **🚀 Start**'ı yeniden açın
* Kendi barındırma: Apps Script özellikleri `APP_URL` (herkese açık HTTPS) ve `APP_API_KEY` kontrol edin
* Eklenti `localhost` kullanamaz — yerel API testi için tünel kullanın
### Could not read your sheet [#could-not-read-your-sheet]
MailG aktif elektronik tabloyu okuyamadı.
* Bir sayfa sekmesinin açık olduğundan emin olun (yalnızca Apps Script düzenleyicisi değil)
* Elektronik tabloyu yeniden yükleyin, ardından iletişim kutusunu yeniden açın
* Dosyaya düzenleme erişiminiz olduğunu doğrulayın
### Loading… hiç bitmiyor [#loading-hiç-bitmiyor]
İletişim kutusunu kapatın, Sheets'i yenileyin, Uzantılar için \~15 saniye bekleyin, ardından tekrar **🚀 Start**.
## Boş sayfa [#boş-sayfa]
**No email address found in your sheet**
MailG en az bir geçerli e-posta sütunu ister.
* Bir başlık altına e-posta ekleyin veya **Fill with mock data**'ya tıklayın
* Mock data `Email`, `First Name`, `Last Name`, `Company` oluşturur ve genellikle **My First Template** ekler
Bkz. [Başlangıç iletişim kutusu turu](/getting-started/start-dialog).
## Şablonlar [#şablonlar]
* Oluşturma: `Creating Template...` → `Template created successfully!` veya `Failed to create template! Try again later.`
* Güncelleme: `Updating template...`
* Silme hataları: `Failed to delete template. Try again later`
Bkz. [Şablonlar](/features/templates).
## Gönderim sorunları [#gönderim-sorunları]
### Gönder düğmesi devre dışı / sayısız Send emails [#gönder-düğmesi-devre-dışı--sayısız-send-emails]
* **Template** seçin
* Hücre başına geçerli **tek** e-posta olan **Recipient column** seçin
* Görebileceğiniz koruma toast'ları: `Configure your recipient column first`, `Select a template first.`, `No valid recipient emails found in the selected column.`
### Kampanya başlamıyor [#kampanya-başlamıyor]
Toast: `Failed to create campaign. Please try again.`
* Bir kez yeniden deneyin
* **Daily quota**'nın 0 olmadığını kontrol edin
* API bağlantısını doğrulayın (yukarıya bakın)
### Satırlar ⚠️ Failed gösteriyor [#satırlar-️-failed-gösteriyor]
O satır gönderim hatasına takıldı (geçersiz adres, Gmail reddi, geçici kota vb.). Veriyi düzeltin ve kalan satırlar için yeni kampanya başlatın veya bkz. [Kampanyayı durdurma](/features/stopping-a-campaign).
### Test e-postası başarısız [#test-e-postası-başarısız]
* `Configure your preview first` — önizlemede To olması için şablon + alıcı seçin
* `Failed to send test email. Please check your email settings.` — gerekirse Gmail'i yeniden yetkilendirin, ardından tekrar deneyin
## Takip [#takip]
* Açılmalar için alıcının uzaktan görselleri yüklemesi gerekir
* **🔄 Refresh Tracking** çalıştırın — `Tracking info synced` veya `No active campaigns` bekleyin
* **👀 Opened** durumu yalnızca piksel yüklendiğinde görünür
Bkz. [E-posta takibi](/features/email-tracking).
## Kota ve markalama [#kota-ve-markalama]
* Kenar çubuğu **N left** = `min(MailG remaining, Gmail remaining)`
* Ücretsiz `@gmail.com` Professional olsa bile Google tarafından genellikle \~500/gün sınırlanır
* Ödemeden sonra filigran hâlâ var → ödeme e-postası Sheets hesabıyla eşleşmeli; iletişim kutusunu yeniden açın
Bkz. [Günlük kota ve incelemeler](/help/daily-quota-and-reviews) ve [Markalamayı kaldırma](/features/remove-branding).
## Zamanlama ertelenmedi [#zamanlama-ertelenmedi]
Yaklaşık **15 saniyeden** az ilerideki zamanlar **anında** gönderim (🚀 sütunu) sayılır, ertelenmiş 🗓️ zamanlama değil. Daha ileri bir zaman seçin.
## Hâlâ takıldınız mı? [#hâlâ-takıldınız-mı]
Tam SSS: [SSS](/help/faq) · E-posta [contact@mailg.io](mailto:contact@mailg.io) · Site [app.mailg.io/help](https://www.mailg.io/tr/help)
# Günlük kota ve incelemeler (/tr/help/daily-quota-and-reviews)
Ana kenar çubuğu, hesap verileri yüklendiğinde gönderim kapasitenizi gösterir.
## Daily quota bloğu [#daily-quota-bloğu]
Tam UI:
* Etiket: **Daily quota**
* Kalan: **N left**
* Plan satırı: **Your plan sends up to TOTAL/day**
**Remaining** şunların minimumudur:
1. Gün için kalan MailG plan kotası
2. Hesap için kalan Gmail gönderim kotası
Yani MailG kağıt üzerinde alan gösterse bile Gmail tarafından sınırlanabilirsiniz. Ayrıca bkz. [Hesap ve faturalandırma](/help/account-and-billing).
## Ücretsiz plan CTA'ları [#ücretsiz-plan-ctaları]
Abone değilseniz kenar çubuğunda şunlar görünebilir:
* **Leave a 5★ review for +N/day free** (API aksi belirtmedikçe varsayılan bonus **+50/day**)
* **Or upgrade your plan**
İnceleme CTA'sına tıklamak **Free Quota upgrade**'i açar:
* Başlık: **Free Quota upgrade**
* Gövde: ücretsiz kota yükseltmesi **+N emails/day** almak için 5 yıldız inceleme bırakın
* Düğmeler: **Not now** | **Leave a 5★ review**
İnceleme URL'si yapılandırılmamışsa **Leave a 5★ review** devre dışı kalır — bunun yerine **Upgrade to Pro** / pricing kullanın.
## Pro’ya yükselt [#proya-yükselt]
Alt bilgi düğmesi (ücretsiz hesaplar): **Upgrade to Pro**
Tooltip: `Unlock higher quota, send pacing, and remove branding`
Bu, ücretli planların bugün üründe açtıklarıyla eşleşir.
## İlgili [#i̇lgili]
* [Markalamayı kaldırma](/features/remove-branding)
* [Send pacing](/features/send-pacing)
* [SSS](/help/faq)
# Hesap ve faturalandırma (/tr/help/account-and-billing)
MailG faturalandırması Sheets'teki **Google hesabı e-postanıza** bağlıdır. Kotaların eklentide açılması için her zaman aynı adresle ödeme yapın.
## Planlar ve günlük kotalar [#planlar-ve-günlük-kotalar]
| Plan | Günlük kota | Notlar |
| ------------ | ----------- | ------------------------------------- |
| Free | 50 | Temel merge, açılma takibi, zamanlama |
| Personal | 250 | Büyüyen listeler için popüler plan |
| Professional | 1.500 | En yüksek yinelenen kota |
| Lifetime | 1.500 | Tek seferlik satın alma |
Fiyatlar ve aralıklar [app.mailg.io/pricing](https://app.mailg.io/pricing?lang=tr) adresinde listelenir (EUR ve USD).
Ücretli haklar ayrıca şunları açar:
* Varsayılan olmayan [send pacing](/features/send-pacing) (**Steady pace** / **Jittered gaps**)
* [Remove branding](/features/remove-branding)
Etkin gönderim hacminiz `min(MailG daily quota, Gmail remaining quota)`'dır.
## Nasıl yükseltilir [#nasıl-yükseltilir]
1. [pricing](https://app.mailg.io/pricing?lang=tr) sayfasını açın (eklentiden **Upgrade to Pro** ile de bağlantılı).
2. Bir plan seçin ve Sheets Google e-postanızla Stripe Checkout'u tamamlayın.
3. Hesap yenilemesinin yeni limiti alması için MailG'yi Sheets'te yeniden açın.
## Aboneliği iptal etme veya güncelleme [#aboneliği-iptal-etme-veya-güncelleme]
Abonelik / pricing akışındaki Stripe müşteri portalından aboneliği iptal edebilir veya değiştirebilirsiniz.
* Dönem ortasında iptal ederseniz Premium özellikler ücretli dönem sonuna kadar aktif kalır
* İptal yürürlüğe girdikten sonra tekrar ücret alınmaz
## İadeler [#i̇adeler]
Satın almadan **30 gün** içinde Premium aboneliği iptal ederseniz [contact@mailg.io](mailto:contact@mailg.io) adresine yazarak tam iade talep edebilirsiniz.
## Faturalar [#faturalar]
Stripe başarılı ödemeler için makbuz e-postası gönderir. Abonelik yönetiminde kullanılan Stripe müşteri portalından faturaları da indirebilirsiniz.
## SSS parçaları [#sss-parçaları]
**MailG Google Workspace'e dahil mi?**\
Hayır. MailG Google'dan bağımsızdır. Workspace aboneliği MailG'yi içermez.
**Hangi ödeme yöntemleri kabul ediliyor?**\
Stripe üzerinden büyük kartlar, Google Pay ve Apple Pay. PayPal desteklenmiyor.
**Ödedim ama hâlâ ücretsiz limit / filigran görüyorum**\
Neredeyse her zaman e-posta uyuşmazlığı. Ödeme e-postası = Sheets hesap e-postası, ardından eklentiyi yeniden açın. Devam ederse her iki e-postayla desteğe yazın.
**Ücretsiz Gmail neden günde yaklaşık 500 e-postayla sınırlı?**\
MailG Professional günde 1.500'e kadar izin verir; ancak Google'ın kendisi ücretsiz `@gmail.com` hesaplarını günde kabaca 500 gönderimle sınırlar. Google Workspace hesapları daha yüksek olabilir. Bu Gmail sağlayıcı limitidir, MailG limiti değil.
# Kampanya zamanlama (/tr/features/campaign-scheduling)
Gönderimin MailG tarafından daha sonra başlamasını istediğinizde **Schedule send** kullanın. Ücretsiz ve ücretli planlarda kullanılabilir.
## Nasıl zamanlanır [#nasıl-zamanlanır]
1. Gönder düğmesinin etkin olması için şablon ve alıcıları yapılandırın.
2. Gönder menüsünü (chevron) açın → **Schedule send**.
3. İletişim kutusu başlığı: **Schedule send**
4. Açıklama: `Pick date & time to schedule sending`
5. Özet satırı: seçilen tarih/saatte başlamak üzere N e-posta zamanlanıyor
6. Tarih seçici ile **Hour** / **Minute** kullanın (placeholder'lar `Hour`, `Min`).
7. **Schedule Send** (veya **Cancel**) ile onaylayın.
Varsayılan öneri yaklaşık **60 dakika ilerisi**, bir sonraki **15 dakikalık** adıma yuvarlanır.
## Anında ve zamanlanmış [#anında-ve-zamanlanmış]
Yaklaşık **15 saniyeden** az ilerideki zamanlar **anında** gönderim (🚀 sütun başlığı) sayılır, ertelenmiş 🗓️ zamanlama değil. Ertelenmiş gönderim için daha ileri bir zaman seçin.
Doğrulama toast'ları: `Please select a date and time`, `Invalid date and time`, `Pick a date and time in the future`.
Başarı toast'ı: kampanya zamanlandı; N e-posta seçilen zamanda başlayacak.
## Sayfa sütunu [#sayfa-sütunu]
Zamanlanmış kampanyalar şuna benzer bir sütun başlığı oluşturur:
```text
🗓️ Template name (yyyy/MM/dd)
```
Anında gönderimler 🗓️ yerine 🚀 kullanır.
Satırlar **🗓️ Scheduled** olarak başlar, kuyruk çalışınca **⏳ Sending…** olur.
## Zamanladıktan sonra [#zamanladıktan-sonra]
* Elektronik tabloya eklentinin sahibi Google hesabının erişimi olsun
* Gönderim başlayınca takip ve pacing yine geçerlidir
* **Manage Schedule** UI yok — bkz. [Kampanyayı durdurma](/features/stopping-a-campaign)
## İlgili [#i̇lgili]
* [Önizleme ve test](/features/preview-and-test)
* [Send pacing](/features/send-pacing)
# Birden fazla alıcı (/tr/features/multiple-recipients)
Satır başına karbon kopya alıcıları özel sayfa sütunlarıyla ekleyebilirsiniz.
## Alıcı sütunu (Kime) [#alıcı-sütunu-kime]
Kenar çubuğunda **Recipient column** seçin.
Gönder düğmesi sayımı ve sütun doğrulaması için MailG, hücre **tek** e-posta adresi olduğunda geçerli sayar. Satır başına bir birincil To adresi tercih edin.
## CC ve BCC sütunları [#cc-ve-bcc-sütunları]
1. Sayfada sütun ekleyin (örneğin `CC` ve `BCC`).
2. Hücreye bir e-posta (veya Gmail'in kabul ettiği liste) yazın.
3. **More options**'ı açın ve **CC** / **BCC** eşleyin.
4. Gönderimde bu değerler Gmail'e iletilir.
Önizleme bölmesi yalnızca **From**, **To**, **Subject** ve gövdeyi gösterir. Eşlense bile CC/BCC satırlarını **göstermez**. CC/BCC teslimatını doğrulamak için **Send me a test email** kullanın.
## Kotalar: MailG ve Gmail [#kotalar-mailg-ve-gmail]
* **MailG günlük kotası** işlenen **kampanya satırlarını** sayar.
* **Gmail gönderim limitleri** **alıcıları** sayar (To + CC + BCC, Gmail'in o gönderimde kabul ettiği adresler).
MailG kotası kalırken Gmail limitine takılabilirsiniz.
## İpuçları [#i̇puçları]
* Alıcılar birbirini görmemeli ise **BCC** tercih edin
* Kullanılmıyorsa CC/BCC eşlemeyin
* Büyük gönderimden önce adresleri doğrulayın
# Attachments (/tr/features/attachments)
## Current status [#current-status]
Under **More options** you may see an **Attachments** control. That UI is **not wired through to Gmail send** today: chosen files are **not** attached to outbound messages.
Treat attachments as a **known gap**, not a supported workflow.
## Workaround: link the file [#workaround-link-the-file]
Until attachments ship:
1. Upload the file to [Google Drive](https://drive.google.com) (or any public host).
2. Share with **Anyone with the link** → **Viewer**.
3. In the template body, use **Insert link** with clear text (“Download PDF”, “Open invoice”).
4. Confirm with **Send me a test email**.
Same pattern as [Images](/features/images) (links only — no embed control).
## What still works without attachments [#what-still-works-without-attachments]
* Personalized body merge tags
* Preview + test email
* Schedule send, tracking, CC/BCC columns
* Paid pacing and remove branding
## Coming later [#coming-later]
Real file attachments (and clearer UI when they work) are on the roadmap. Until then, prefer Drive / HTTPS links in the body.
## Related [#related]
* [Features overview](/features/features-overview) (known gaps table)
* [Images](/features/images)
* [FAQ](/help/faq)
# Özellikler genel bakış (/tr/features/features-overview)
Eklentinin bugün destekledikleri:
| Özellik | Dokümantasyon |
| ------------------------------------------- | --------------------------------------------------------------- |
| Start dialog / empty sheet / mock data | [Başlangıç iletişim kutusu turu](/getting-started/start-dialog) |
| Templates (create / manage / edit / delete) | [Şablonlar](/features/templates) |
| Merge tags in **body** | [Birleştirme etiketleri](/features/merge-tags) |
| Rich-text toolbar | [Zengin metin e-postaları](/features/rich-text-emails) |
| Links (not image embeds) | [Görseller](/features/images) |
| Preview + test email | [Önizleme ve test](/features/preview-and-test) |
| Schedule send | [Kampanya zamanlama](/features/campaign-scheduling) |
| Send pacing (paid) | [Send pacing](/features/send-pacing) |
| CC / BCC columns | [Birden fazla alıcı](/features/multiple-recipients) |
| Track emails | [E-posta takibi](/features/email-tracking) |
| Sender name & reply-to | [Özelleştirilmiş gönderen](/features/customized-sender) |
| Remove branding (paid) | [Markalamayı kaldırma](/features/remove-branding) |
| Stop remaining rows | [Kampanyayı durdurma](/features/stopping-a-campaign) |
| Daily quota + review bonus | [Günlük kota ve incelemeler](/help/daily-quota-and-reviews) |
## Ücretli ve ücretsiz [#ücretli-ve-ücretsiz]
Ücretli plan şunları açar:
* Varsayılan olmayan [send pacing](/features/send-pacing)
* [Remove branding](/features/remove-branding)
* Daha yüksek [günlük kotalar](/help/account-and-billing)
**Schedule send**, **Track emails** ve şablon araçları ücretli yükseltme olmadan çalışır.
## Bilinen eksikler (dürüstçe) [#bilinen-eksikler-dürüstçe]
| Konu | Üründeki durum |
| ----------------------- | -------------------------------------------- |
| Subject merge tags | Gönderimde uygulanmıyor — yalnızca gövde |
| Attachments column | Yalnızca UI — gönderimde eklenmiyor |
| Image embeds | Düzenleyici kontrolü yok — bağlantı kullanın |
| Preview CC/BCC lines | Önizleme UI'ında gösterilmiyor |
| Manage Schedule / Pause | Henüz yok — durum geçici çözümü |
## Daha sonra gelecek [#daha-sonra-gelecek]
Abonelikten çıkma bağlantıları, tıklama takibi, paylaşımlı ekip koltukları ve yayınlandığında ayrı bir kampanya yöneticisi UI'ı.
# E-posta takibi (/tr/features/email-tracking)
MailG, küçük görünmez bir pikselle açılmaları kaydedebilir.
## Takibi etkinleştirme [#takibi-etkinleştirme]
Kenar çubuğunda **Track emails**'i açık bırakın (yeni işler için varsayılan açık).
Tooltip: `Track emails opened with a tiny pixel`
Yardım simgesi **Email tracking**'i açar:
> When enabled, MailG adds a tiny invisible pixel to each email so you can see which messages were opened. Tracking status appears in your sheet campaign column.
Düğme: **Got it**
## Sayfa durumları [#sayfa-durumları]
| Durum | Anlam |
| ------------- | -------------------------------- |
| 🗓️ Scheduled | Zamanlanmış başlangıç bekleniyor |
| ⏳ Sending… | Şu an işleniyor |
| ✉️ Sent | O satır için Gmail'e iletildi |
| ⚠️ Failed | O satır için gönderim hatası |
| 👀 Opened | Açılma pikseli yüklendi |
Kampanya sütun başlıkları `🚀 Template name (yyyy/MM/dd)` veya zamanlandıysa `🗓️ …` gibi görünür.
## Takibi yenileme [#takibi-yenileme]
**Extensions → MailG for Gmail → 🔄 Refresh Tracking**
Apps Script uyarıları:
* `Tracking info synced`
* `No active campaigns`
## Sınırlamalar [#sınırlamalar]
* İstemci uzaktan görselleri yüklemeli
* Gizlilik vekil sunucuları açılmaları gizleyebilir
* Yalnızca açılmalar — bağlantı tıklamaları değil
## İlgili [#i̇lgili]
* [Kampanya zamanlama](/features/campaign-scheduling)
* [SSS](/help/faq)
# Birleştirme etiketleri (/tr/features/merge-tags)
Birleştirme etiketleri her alıcının kişiselleştirilmiş bir **gövde** almasını sağlar. Etiket, çift süslü parantez içinde **tam sütun başlığıdır**.
## Sözdizimi [#sözdizimi]
Sayfanızda `First Name` adlı bir sütun varsa şunu kullanın:
```text
{{First Name}}
```
Gövde örneği:
```text
Hi {{First Name}},
Thanks for your work at {{Company}}.
```
## Birleştirme etiketlerinin bugün çalıştığı yerler [#birleştirme-etiketlerinin-bugün-çalıştığı-yerler]
| Alan | Gönderimde birleştirilir? |
| --------------- | ---------------------------------------------------- |
| Email body | **Evet** — değişkenler satır başına enjekte edilir |
| Email subject | **Hayır** — konu şablonda kayıtlı haliyle gönderilir |
| Preview body | **Evet** — aktif satır için |
| Preview subject | **Hayır** — ham şablon konusunu gösterir |
Konu birleştirmesi gelene kadar kişiselleştirmeyi gövdeye koyun.
## Etiket ekleme [#etiket-ekleme]
Düzenleyici araç çubuğunda **Merge Tag**'i açın. Aktif sayfadaki başlıkları listeler. Boş durum: `No sheet columns found`.
Eklenen metin sütun adının etrafında çift süslü parantez kullanır.
## Pratik kurallar [#pratik-kurallar]
* Başlıklar büyük/küçük harfe duyarlıdır (`Name` ≠ `name`)
* Boş hücreler boş dize olarak eklenir
* Aynı etiketi gövdede birden fazla kullanabilirsiniz
* Alıcı / CC / BCC **More options** altında seçilir, birleştirme etiketiyle değil
## Sonraki [#sonraki]
Bkz. [Zengin metin e-postaları](/features/rich-text-emails) ve [Önizleme ve test](/features/preview-and-test).
# Zengin metin e-postaları (/tr/features/rich-text-emails)
MailG şablonları TipTap zengin metin düzenleyicisi kullanır. Ürettiği HTML Gmail'in ilettiği içeriktir.
Gövde placeholder'ı: `Write your email…`
## Araç çubuğu envanteri (tam UI) [#araç-çubuğu-envanteri-tam-ui]
| Grup | Kontroller |
| ----------- | -------------------------------------------------------------------------------------------------------- |
| Merge | **Merge Tag** |
| Font family | **System Font**, **Arial**, **Georgia**, **Times New Roman**, **Verdana**, **Courier New** |
| Font size | **10pt** … **24pt** (araç çubuğunda ön ayarlar) |
| Marks | **Bold**, **Italic**, **Underline**, **Strikethrough**, **Text color**, **Clear formatting** |
| Color | Ön ayar renkleri + yerel renk seçici + **Reset** |
| Align | **Align left**, **Align center**, **Align right**, **Justify** |
| Lists | **Bullet list**, **Numbered list** |
| Link | **Insert link** — URL alanı placeholder `https://example.com`, ardından **Apply** (ve bağlantı kaldırma) |
| History | **Undo**, **Redo** |
## Düzenleyicide olmayanlar [#düzenleyicide-olmayanlar]
Bu TipTap özellikleri devre dışı / yok:
* Headings, code, code block, blockquote, horizontal rule
* Image insert / Drive media picker — bkz. [Görseller](/features/images)
## Köprüler [#köprüler]
URL ve görünen metin için **Insert link** kullanın. Ham URL yerine net bağlantı metni tercih edin.
## İpuçları [#i̇puçları]
* Süslü parantezleri elle yazmak yerine **Merge Tag** kullanın
* Göndermeden önce birkaç satırı önizleyin — bkz. [Önizleme ve test](/features/preview-and-test)
* Büyük yapıştırılmış Word/Docs biçimlendirmesinden kaçının; daha temiz HTML için MailG'de yeniden biçimlendirin
# MailG markasını kaldırma (/tr/features/remove-branding)
Ücretsiz kampanyalarda e-posta alt bilgisinde küçük bir MailG filigranı olabilir. Ücretli aboneler bunu kapatabilir.
## Markalamayı nasıl kaldırılır [#markalamayı-nasıl-kaldırılır]
1. Aktif ücretli planınız olduğunu doğrulayın (Personal, Professional veya Lifetime).
2. Kampanya kenar çubuğunu açın.
3. **Remove branding**'i etkinleştirin.
4. Filigranın gittiğini doğrulamak için bir satırı önizleyin, ardından gönderin.
Ödeme yaptıktan sonra filigran hâlâ görünüyorsa:
* Ödemenin Google Sheets hesabınızla **aynı e-postayla** yapıldığından emin olun
* API'den hakları yenilemek için eklentiyi yeniden açın
* Google hesap e-postanızla [contact@mailg.io](mailto:contact@mailg.io) adresine yazın
Bkz. [Hesap ve faturalandırma](/help/account-and-billing).
# Görseller (/tr/features/images)
MailG düzenleyicisinde **görsel ekleme düğmesi** ve Google Drive medya seçici yoktur. TipTap Image uzantısı etkin değildir.
## Bugün yapabilecekleriniz [#bugün-yapabilecekleriniz]
Araç çubuğunda **Insert link** kullanın:
1. Görseli (veya dosyayı) herkese açık bir URL'de barındırın veya Drive bağlantısı paylaşın.
2. Metni seçin (veya imleci yerleştirin) → **Insert link**.
3. URL'yi yapıştırın (placeholder `https://example.com`) → **Apply**.
Alıcılar görseli veya dosyayı görmek için bağlantıyı açar. Düzenleyici sizin için `![]()
` etiketleri gömmez.
## İpuçları [#i̇puçları]
* Küçük dosyalar ve net bağlantı metni tercih edin («View screenshot»)
* Oturum açma gerektiren bağlantılar alıcılar için çalışmaz
* **Send me a test email** ile doğrulayın
## Daha sonra gelecek [#daha-sonra-gelecek]
Birinci sınıf görsel gömme / Drive seçici daha sonra gelebilir. O zamana kadar köprüler desteklenen yoldur.
# Şablonlar (/tr/features/templates)
Şablonlar kampanyalarda yeniden kullandığınız konu ve zengin metin gövdesini saklar. Google hesabınız için MailG API'sine kaydedilir.
## Şablon oluşturma [#şablon-oluşturma]
1. Ana ekranda **New Template**'e tıklayın.
2. Doldurun:
* **Template Name**
* **Email Subject**
* Gövde (zengin düzenleyici — bkz. [Zengin metin e-postaları](/features/rich-text-emails))
3. **Save Template**'e tıklayın (çalışırken **Saving...** gösterir).
Toast'lar:
* Yükleniyor: `Creating Template...`
* Başarı: `Template created successfully!`
* Hata: `Failed to create template! Try again later.`
**Fill with mock data** demo şablonu: ad **My First Template**, konu `I found a mail merge tool for Gmail`.
## Şablonları yönetme [#şablonları-yönetme]
Şablon seçiminin yanındaki şablon simgesini açın (tooltip **Manage templates**).
Tablo sütunları:
| Sütun | İçerik |
| ----------------- | ------------------ |
| **Name** | Şablon adı |
| **Email Subject** | Konu satırı |
| **Created At** | Oluşturulma tarihi |
| **Actions** | Satır menüsü |
Satır menüsü: **Edit** | **Delete**
Alt bilgi: **Back**
Silme toast'ları: deleting template NAME → template NAME deleted successfully (veya hata mesajı).
## Şablon düzenleme [#şablon-düzenleme]
Yönetimden **Edit** açın veya önizleme araç çubuğunda **Edit template**'e tıklayın.
Oluşturmayla aynı alanlar. **Save Template** şablonu günceller.
Güncelleme akışı yükleme toast'ı gösterir (`Updating template...`). Bitene kadar formda kalın, otomatik dönmezseniz **Cancel** veya **Back** kullanın.
## Konu ve gövde [#konu-ve-gövde]
* **Body** [birleştirme etiketlerini](/features/merge-tags) destekler — gönderimde satır başına enjekte edilir.
* **Email Subject** bugün kaydedildiği gibi gönderilir (konudaki birleştirme etiketleri **henüz** değiştirilmez). Kişiselleştirmeyi gövdeye koyun veya sabit konu kullanın.
## İlgili [#i̇lgili]
* [Önizleme ve test](/features/preview-and-test)
* [Başlangıç iletişim kutusu turu](/getting-started/start-dialog)
# Önizleme ve test (/tr/features/preview-and-test)
Önizleme bölmesi (ana iletişim kutusunun sağ tarafı) aktif sayfa satırı için mesajın nasıl göründüğünü gösterir.
## Önizlemenin gösterdikleri [#önizlemenin-gösterdikleri]
| Alan | İçerik |
| ------------ | ----------------------------------------------------------------------------- |
| **From:** | Oturum açmış Google hesabı e-postanız |
| **To:** | Aktif satır için **Recipient column** değeri veya `Select a recipient column` |
| **Subject:** | Kayıtlı şablon konusu (merge ile değiştirilmez) |
| Body | O satır için birleştirme etiketleri uygulanmış şablon gövdesi |
**Remove branding** kapalıysa önizleme MailG filigran alt bilgisini içerir (`made and sent with` / **MailG** / `Email Marketing from Gmail`).
## Gösterilmeyenler [#gösterilmeyenler]
* **CC** / **BCC** satırları önizleme UI'ında gösterilmez (**More options** altında eşlense bile). Gönderimde yine uygulanır.
* Ek sütunu değerleri önizlemede gösterilmez.
## Satırlar arasında gezinme [#satırlar-arasında-gezinme]
Önizleme araç çubuğu:
* **Edit template** — update-template ekranını açar
* **Previous recipient** / **Next recipient** — veri satırları arasında geçiş (tooltip'ler sayfa satır numarasını içerebilir; başlık satır 1, ilk kişi satır 2)
## Bana test e-postası gönder [#bana-test-e-postası-gönder]
1. Önizlemenin geçerli olması için şablon + recipient column yapılandırın.
2. Gönder menüsünü (chevron) açın → **Send me a test email**.
3. Meşgul katmanı: `Sending test email…`
4. Başarı toast'ı: `Test email sent successfully. Check your inbox.`
5. Hata toast'ı: `Failed to send test email. Please check your email settings.`
6. Önizleme eksikse koruma: `Configure your preview first`
Test, aktif önizleme satırının birleştirilmiş gövdesiyle **sizin** Google hesabı gelen kutunuza gider.
## İpuçları [#i̇puçları]
* Tam gönderimden önce oklarla birkaç satırı adım adım inceleyin
* Önizlemede branding / branding yokluğunu doğrulayın
* **Schedule send** veya büyük **Send N email(s)** öncesinde her zaman test edin
## İlgili [#i̇lgili]
* [Birleştirme etiketleri](/features/merge-tags)
* [Mail merge eğitimi](/getting-started/mail-merge-tutorial)
# Gönderim hızı (/tr/features/send-pacing)
Send pacing, büyük bir kampanyanın hesabınızdan tek seferde patlama gibi çıkmaması için mesajlar arası gecikme ekler.
**Steady pace** ve **Jittered gaps** aktif ücretli MailG aboneliği gerektirir. Ücretsiz hesaplar yalnızca **Burst send** kullanır.
## Nerede yapılandırılır [#nerede-yapılandırılır]
Alt bilgi dişlisini açın (tooltip **Send pacing**). Ekran başlığı: **Send pacing**.
**Dispatch mode** altında e-postaların nasıl aralıklı gönderileceğini seçin. **Gap between emails** **saniye** cinsindendir (0–60). Ücretsiz hesaplarda **Pro features** ve kilitli metin görünür: `Free plans use burst send only. Upgrade to Pro to space out your campaigns.`
Yeni işler için varsayılan: **Burst send**, gap **10s** (burst'tan çıkana kadar gap yok sayılır).
## Modlar [#modlar]
| Mod (UI etiketi) | Davranış |
| --------------------------- | ------------------------------------------------------ |
| **Burst send** (varsayılan) | Kotalar izin verdiği kadar hızlı gönder |
| **Steady pace** | Her e-posta arasında sabit gap bekle |
| **Jittered gaps** | 0 ile seçtiğiniz üst sınır arasında rastgele gap bekle |
## Neden pacing kullanılır [#neden-pacing-kullanılır]
* Posta sağlayıcılarına ani patlama gibi görünme olasılığını azaltır
* Uzun listeyi daha sakin bir gönderim penceresine yayar
* Hesap türünüz için Gmail'in rahat bölgelerinde kalır
## Notlar [#notlar]
* Pacing işle birlikte saklanan bir kampanya ayarıdır — yeni gönderimler güncel yapılandırmayı kullanır
* Büyük listede uzun gap toplam kampanya süresini önemli ölçüde artırır
* Etkin hızınız yine MailG günlük kotası **ve** Gmail'in kalan gönderim kotasıyla sınırlıdır
* Rakip araçlar bazen gecikmeyi dakikada ifade eder — MailG **saniye** kullanır
## İlgili [#i̇lgili]
* Çalışma sırasında gap çok yüksek ayarlandıysa [Kampanyayı durdurma](/features/stopping-a-campaign)
* [Hesap ve faturalandırma](/help/account-and-billing)
# Kampanyayı durdurma (/tr/features/stopping-a-campaign)
MailG henüz bazı rakiplerdeki gibi ayrı bir **Manage Schedule**, **Abort** veya **Pause** ekranı sunmuyor. Yine de **kalan** satırların gönderilmesini durdurabilirsiniz.
## Gönderim hangi satırları işler [#gönderim-hangi-satırları-işler]
Gönderim döngüsü yalnızca kampanya sütunu durumu hâlâ gönderilebilir olan satırları işler:
* ⏳ Sending… / legacy `Pending...`
* 🗓️ Scheduled / legacy `Scheduled`
Zaten **✉️ Sent**, **⚠️ Failed** veya **👀 Opened** işaretli satırlar atlanır.
## Kalan satırları durdurma (dürüst geçici çözüm) [#kalan-satırları-durdurma-dürüst-geçici-çözüm]
Büyük kampanyada hızlı hareket edin:
1. Elektronik tabloyu açın.
2. Kampanya durum sütununda **gönderilmemesi** gereken satırların durumunu temizleyin veya değiştirin (örneğin hücre değerini silin veya `Stopped` gibi gönderilemez bir etiket yazın).
3. Zaten **✉️ Sent** olan satırlara dokunmayın — o mesajlar çoktan çıkmıştır.
Temizlediğiniz/değiştirdiğiniz satırlar artık gönderilebilir durumlarla eşleşmez; kuyruk sonraki geçişte atlar.
Hesaptan çıkan Gmail mesajları MailG ile geri alınamaz. Durdurma yalnızca henüz işlenmemiş satırları korur.
## Henüz başlamamış zamanlanmış kampanyalar [#henüz-başlamamış-zamanlanmış-kampanyalar]
Her satır hâlâ **🗓️ Scheduled** ve başlangıç zamanı gelmediyse, o durumları (veya kampanya sütununu) temizlemek zaman gelince kuyruğun almasını engeller.
Emin değilseniz elektronik tablo URL'si ve kampanya ayrıntılarıyla [contact@mailg.io](mailto:contact@mailg.io) adresine yazın.
## İlgili [#i̇lgili]
* [Kampanya zamanlama](/features/campaign-scheduling)
* [Send pacing](/features/send-pacing)
* [SSS](/help/faq)
# Özelleştirilmiş gönderen (/tr/features/customized-sender)
Varsayılan olarak Gmail, MailG'ye yetki veren Google hesabından gönderir. Adınızın nasıl göründüğünü ve yanıtların nereye gideceğini yine özelleştirebilirsiniz.
## Gönderen adı [#gönderen-adı]
1. Kampanya kenar çubuğunda **More options**'ı açın.
2. **Sender name** ayarlayın (placeholder `John Doe (Optional)`).
3. Alıcılar gelen kutusunda bu görünen adı görür (Gmail'in olağan sunum kurallarına tabi).
## Yanıt adresi [#yanıt-adresi]
Yanıtlar gönderen hesaptan farklı bir yere gitmeli ise **Reply to address** ayarlayın (placeholder `john@doe.com (Optional)`).
## Notlar [#notlar]
* Alttaki From adresi yetkili Gmail hesabı kalır — başka bir posta kutusunu taklit edemezsiniz
* Geçersiz reply-to adresleri teslimat veya yanıt sorunlarına yol açabilir — kontrol ettiğiniz bir posta kutusu kullanın
* Önizleme **From:**'u oturum açmış e-postanız olarak gösterir; reply-to'yu **Send me a test email** ile doğrulayın
* Bkz. [Önizleme ve test](/features/preview-and-test)
# Başlangıç iletişim kutusu turu (/tr/getting-started/start-dialog)
Eklentiyi **Extensions → MailG for Gmail → 🚀 Start** ile açın. **MailG for Gmail** başlıklı 900×600 iletişim kutusu açılır.
## Ekranlar [#ekranlar]
| Ekran | Nasıl ulaşılır | Amaç |
| -------------------- | --------------------------------------------- | ---------------------------------- |
| Root (oluşturucu) | Yüklemeden sonra varsayılan | Şablon + alıcı seç, önizle, gönder |
| Create template | **New Template** | Ad, konu, gövde |
| Manage templates | Şablon simgesi (tooltip **Manage templates**) | Listele, düzenle, sil |
| Update template | **Edit template** veya satır **Edit** | Mevcut şablonu düzenle |
| Settings | Alt bilgi dişli (tooltip **Send pacing**) | Dispatch mode + gap |
| Empty sheet | Geçerli e-posta sütunu yok | Kişi veya mock data ekle |
| API / sayfa hataları | Yükleme hatası | Yeniden deneme rehberi |
## Root düzeni [#root-düzeni]
Üç bölge:
1. **Sidebar** (sol) — şablon, recipient column, **More options**, tracking, branding, quota
2. **Preview** (sağ) — From / To / Subject / body, satır gezinme, **Edit template**
3. **Footer** — gönder düğmesi, gönder menüsü, **Upgrade to Pro** (ücretsiz), settings, help
## Kenar çubuğu kontrolleri (tam etiketler) [#kenar-çubuğu-kontrolleri-tam-etiketler]
* **New Template**
* **Template** (select) — placeholder `Select` veya `No templates found`
* **Recipient column** — `A - Email` gibi seçenekler; boş: `No valid email columns found.`
* **More options** — **Attachments**, **CC**, **BCC**, **Sender name**, **Reply to address** alanlarını açar
* **Track emails** (varsayılan açık)
* **Remove branding** (ücretli)
* **Daily quota** — kalan sayı «N left» ve plan satırı «Your plan sends up to TOTAL/day»
Ücretsiz hesaplarda ayrıca **Leave a 5★ review for +N/day free** ve **Or upgrade your plan** görünür. Bkz. [Günlük kota ve incelemeler](/help/daily-quota-and-reviews).
## Alt bilgi gönder kontrolleri [#alt-bilgi-gönder-kontrolleri]
| Kontrol | Etiket |
| ------------------ | ------------------------------------------------------------------------------------- |
| Birincil düğme | **Send N email(s)** (sayı 0 iken **Send emails**) |
| Gönder menüsü | **Send me a test email** |
| Gönder menüsü | **Schedule send** |
| Upgrade (ücretsiz) | **Upgrade to Pro** — tooltip: `Unlock higher quota, send pacing, and remove branding` |
| Dişli | tooltip **Send pacing** |
| Help | tooltip **Help** — iletişim kutusundaki kontrol listesini açar |
### Need help? kontrol listesi [#need-help-kontrol-listesi]
1. Şablon ve recipient column seçin
2. Oklarla her satırı önizleyin
3. Önce kendinize test e-postası gönderin
4. Sayfanızdan merge göndermek için Send'e tıklayın
Düğmeler: **Open docs** ([docs.mailg.io](https://docs.mailg.io)) | **View pricing** (varsa) | **Close**
## Boş sayfa [#boş-sayfa]
MailG geçerli e-posta sütunu bulamazsa:
* Başlık: **No email address found in your sheet**
* Eylemler: **Close** | **Fill with mock data**
Mock data `Email`, `First Name`, `Last Name`, `Company` başlıklarını ekler ve **My First Template** oluşturabilir.
## Hata ekranları [#hata-ekranları]
| Başlık | Ne zaman |
| --------------------------------- | ------------------ |
| **Could not reach the MailG API** | API / ağ hatası |
| **Could not read your sheet** | Sayfa okuma hatası |
## Sonraki [#sonraki]
# Kurulum (/tr/getting-started/installation)
İki adım: eklentiyi yükleyin, ardından Sheets'ten başlatın.
## MailG'yi yükleyin [#mailgyi-yükleyin]
1. [Google Workspace Marketplace'teki MailG listesini](https://workspace.google.com/marketplace/app/mailg) açın.
2. **Install**'a tıklayın.
3. Kurulumun sahibi olması gereken Google hesabını seçin.
4. İzinleri inceleyin ve **Allow**'a tıklayın.
Kurulum genellikle 15 saniyeden kısa sürer. Eklentinin yüklendiğine dair bir onay görmelisiniz.
Marketplace listesi bölgenizde henüz yayında değilse [www.mailg.io](https://www.mailg.io) adresindeki kurulum CTA'sını kullanın veya [contact@mailg.io](mailto:contact@mailg.io) adresine yazın.
## Google Sheets'te MailG'yi başlatın [#google-sheetste-mailgyi-başlatın]
1. [Google Sheets](https://sheets.google.com)'i açın (Sheets zaten açıksa yenileyin).
2. Uzantıların yüklenmesi için birkaç saniye bekleyin (genellikle \~10–15 saniye).
3. **Extensions → MailG for Gmail → 🚀 Start** yolunu izleyin.
Daha sonra tam iletişim kutusunu açmadan açılma durumlarını senkronize etmek için **Extensions → MailG for Gmail → 🔄 Refresh Tracking** çalıştırabilirsiniz.
## Kurulum sorunları [#kurulum-sorunları]
Bunlar MailG hataları değil, yaygın Google Workspace özellikleridir:
### "Başarıyla yüklendi" açılır penceresini hiç görmüyorum [#başarıyla-yüklendi-açılır-penceresini-hiç-görmüyorum]
Birden fazla Google hesabıyla oturum açıldığında ve kurulum beklediğiniz hesapla yapılmadığında sık görülür.
**Geçici çözüm:** gizli/özel pencere açın, yalnızca hedef hesapla oturum açın, ardından Marketplace'ten tekrar yükleyin.
### MailG, Extensions altında görünmüyor [#mailg-extensions-altında-görünmüyor]
1. Elektronik tabloyu yenileyin.
2. Eklentilerin yüklenmesi için yaklaşık 10–15 saniye bekleyin.
3. MailG'yi yüklediğiniz Google hesabında olduğunuzu doğrulayın.
4. Hâlâ yoksa başka bir elektronik tablo deneyin veya tarayıcı önbelleğini temizleyin.
## Kendi barındırdığınız / özel dağıtımlar [#kendi-barındırdığınız--özel-dağıtımlar]
Marketplace kurulumları önceden yapılandırılmıştır. MailG'yi kendiniz dağıtıyorsanız Apps Script script özelliklerini ayarlayın:
| Özellik | Değer |
| ------------- | ----------------------------------------- |
| `APP_URL` | MailG API'nizin herkese açık HTTPS URL'si |
| `APP_API_KEY` | API sunucusuyla aynı anahtar |
Eklenti Google sunucularından `localhost`'a erişemez — yerel test için tünel (Cloudflare Tunnel, ngrok vb.) kullanın.
## Sonraki [#sonraki]
[Mail merge eğitimi](/getting-started/mail-merge-tutorial) ile devam edin.
# Mail merge eğitimi (/tr/getting-started/mail-merge-tutorial)
Bu adım adım rehber **MailG for Gmail** başlangıç iletişim kutusuyla eşleşir.
## 1. MailG'yi açın [#1-mailgyi-açın]
**Extensions → MailG for Gmail → 🚀 Start**.
**No email address found in your sheet** görürseniz gerçek e-postalar ekleyin veya **Fill with mock data**'ya tıklayın (örnek satırlar ve genellikle **My First Template** oluşturur). Bkz. [Başlangıç iletişim kutusu turu](/getting-started/start-dialog).
## 2. Şablon oluşturun veya seçin [#2-şablon-oluşturun-veya-seçin]
1. **New Template**'e tıklayın (veya **Template** altında mevcut birini seçin).
2. **Template Name** ve **Email Subject** ayarlayın (konu bugün **merge ile değiştirilmiyor**).
3. Gövdeyi yazın ve **Merge Tag** ile [birleştirme etiketleri](/features/merge-tags) ekleyin.
4. **Save Template**.
Gövde örneği:
```text
Hi {{First Name}},
I saw that {{Company}} is growing and wanted to share a short idea…
```
## 3. Kampanyayı yapılandırın [#3-kampanyayı-yapılandırın]
Kenar çubuğunda:
1. **Recipient column** seçin (UI sayımı için hücreler geçerli tek e-posta olmalıdır).
2. **CC**, **BCC**, **Sender name**, **Reply to address** için **More options**'ı açın.
3. Sayfada açılma durumu istiyorsanız **Track emails**'i açık bırakın (varsayılan).
4. Ücretli planda **Remove branding**'i etkinleştirin.
**Attachments**, **More options** altında görünür; ancak dosyalar gönderimde henüz eklenmez. Bunun yerine gövdede Drive veya URL bağlantısı kullanın.
## 4. Önizleme ve test [#4-önizleme-ve-test]
1. Satırlar arasında gezinmek için önceki/sonraki okları kullanın.
2. **To:** ve birleştirilmiş gövdeyi doğrulayın (konu ham şablon konusunu gösterir).
3. Gönder menüsü → **Send me a test email**.
4. Gelen kutunuzu kontrol edin.
Ayrıntılar: [Önizleme ve test](/features/preview-and-test).
## 5. Gönder veya zamanla [#5-gönder-veya-zamanla]
* Alıcılar sayıldığında birincil düğme: **Send N email(s)**.
* Veya gönder menüsü → **Schedule send** → tarih/saat seçin → **Schedule Send**.
Meşgul katmanları: `Starting your campaign…` / zamanlama onay toast'ları.
MailG `🚀 My Template (yyyy/MM/dd)` veya zamanlandıysa `🗓️ …` gibi bir kampanya sütunu ekler.
Satır durumları:
| Durum | Anlam |
| ------------- | ----------------------- |
| 🗓️ Scheduled | Başlangıç bekleniyor |
| ⏳ Sending… | İşleniyor |
| ✉️ Sent | Gmail'e iletildi |
| ⚠️ Failed | Hata |
| 👀 Opened | Açılma pikseli yüklendi |
## Sık yapılan hatalar [#sık-yapılan-hatalar]
* Kişiselleştirme bekleyen konu etiketleri — şimdilik yalnızca gövde
* Virgülle ayrılmış birden fazla adres içeren alıcı hücreleri — UI sayım için hücre başına **bir** e-posta doğrular
* Kurulum hesabından farklı Google hesabı
* Günlük kotaya takılma — kenar çubuğundaki **Daily quota**'yı kontrol edin
## İpuçları [#i̇puçları]
* İlk seferde alt bilgi **Help** kontrol listesini kullanın
* Mock data'dan sonra 2–3 gerçek satırla başlayın
* Açılmalardan sonra: **Extensions → MailG for Gmail → 🔄 Refresh Tracking** → `Tracking info synced` (veya `No active campaigns`) uyarısı
## Sonraki [#sonraki]
# MailG nedir? (/tr/getting-started/what-is-mailg)
MailG, bir Google Sheet'i mail merge kampanyasına dönüştürür. Her satır bir alıcıdır; sütun başlıkları **e-posta gövdesinde** birleştirme etiketlerine (başlık adının etrafında çift süslü parantez) dönüşür.
## Neler yapabilirsiniz [#neler-yapabilirsiniz]
* Bulutta saklanan şablonlar oluşturun (**Template Name**, **Email Subject**, zengin gövde)
* Sayfa başlıklarından birleştirme etiketleriyle **gövdeyi** kişiselleştirin
* Satırları önizleyin ve **Send me a test email** gönderin
* **CC** / **BCC**, **Sender name**, **Reply to address** eşleyin
* **Schedule send** veya hemen gönderin
* Sayfada açılma durumu çipleriyle **Track emails** kullanın
* Ücretli planlarda **Send pacing** kontrol edin
* Ücretli planlarda **Remove branding** kullanın
* **Daily quota** izleyin (isteğe bağlı olarak ücretsiz inceleme bonusu talep edin)
## Nasıl bir araya gelir [#nasıl-bir-araya-gelir]
1. **Google Sheets eklentisi** — **MailG for Gmail** altındaki iletişim kutusu
2. **MailG API** — şablonlar, kampanya meta verileri, açılma takibi, haklar
3. **Gmail'iniz** — yetkili hesaptan `GmailApp` ile gönderilen mesajlar
## Sonraki adımlar [#sonraki-adımlar]