The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
Add email campaign guides (#26629)
neo77336bbd1211c66
diff --git a/packages/twenty-docs/docs.json b/packages/twenty-docs/docs.jsonindex c36c91a625d..15c41c86bdd 100644--- a/packages/twenty-docs/docs.json+++ b/packages/twenty-docs/docs.json@@ -156,6 +156,23 @@}]},+ {+ "group": "Email Campaigns",+ "icon": "paper-plane",+ "pages": [+ "user-guide/email-campaigns/overview",+ {+ "group": "How-Tos",+ "pages": [+ "user-guide/email-campaigns/how-tos/set-up-a-sending-domain",+ "user-guide/email-campaigns/how-tos/email-campaign-best-practices",+ "user-guide/email-campaigns/how-tos/send-your-first-campaign",+ "user-guide/email-campaigns/how-tos/create-a-campaign-with-ai",+ "user-guide/email-campaigns/how-tos/manage-unsubscribes-and-topics"+ ]+ }+ ]+ },{"group": "Workflows","icon": "bolt",diff --git a/packages/twenty-docs/images/user-guide/email-campaigns/ai-chat-campaign.png b/packages/twenty-docs/images/user-guide/email-campaigns/ai-chat-campaign.pngnew file mode 100644index 00000000000..f2ad47df322Binary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/ai-chat-campaign.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/campaign-composer.png b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-composer.pngnew file mode 100644index 00000000000..09a92e9c8efBinary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-composer.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/campaign-schedule-panel.png b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-schedule-panel.pngnew file mode 100644index 00000000000..637a48bed8eBinary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-schedule-panel.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/campaign-send-panel.png b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-send-panel.pngnew file mode 100644index 00000000000..4e16c7698f7Binary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-send-panel.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/campaign-send-test.png b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-send-test.pngnew file mode 100644index 00000000000..c1a67ecf8c7Binary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-send-test.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/campaign-sent-results.png b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-sent-results.pngnew file mode 100644index 00000000000..1cdaa024333Binary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-sent-results.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/campaign-variables.png b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-variables.pngnew file mode 100644index 00000000000..6aadf5c70fdBinary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/campaign-variables.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/campaigns-list.png b/packages/twenty-docs/images/user-guide/email-campaigns/campaigns-list.pngnew file mode 100644index 00000000000..46413750ce0Binary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/campaigns-list.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/channels-list.png b/packages/twenty-docs/images/user-guide/email-campaigns/channels-list.pngnew file mode 100644index 00000000000..3be3903583eBinary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/channels-list.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/list-members.png b/packages/twenty-docs/images/user-guide/email-campaigns/list-members.pngnew file mode 100644index 00000000000..65b780e4ccaBinary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/list-members.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/new-channel-form.png b/packages/twenty-docs/images/user-guide/email-campaigns/new-channel-form.pngnew file mode 100644index 00000000000..03894dcfb45Binary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/new-channel-form.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/new-topic-form.png b/packages/twenty-docs/images/user-guide/email-campaigns/new-topic-form.pngnew file mode 100644index 00000000000..6a041bff6bdBinary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/new-topic-form.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/sending-domain-records.png b/packages/twenty-docs/images/user-guide/email-campaigns/sending-domain-records.pngnew file mode 100644index 00000000000..651e3020c66Binary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/sending-domain-records.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/sending-domain-verified.png b/packages/twenty-docs/images/user-guide/email-campaigns/sending-domain-verified.pngnew file mode 100644index 00000000000..b71c11bea42Binary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/sending-domain-verified.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/unsubscribe-page-preview.png b/packages/twenty-docs/images/user-guide/email-campaigns/unsubscribe-page-preview.pngnew file mode 100644index 00000000000..b165d0242f9Binary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/unsubscribe-page-preview.png differdiff --git a/packages/twenty-docs/images/user-guide/email-campaigns/unsubscribers-tab.png b/packages/twenty-docs/images/user-guide/email-campaigns/unsubscribers-tab.pngnew file mode 100644index 00000000000..e939251bc0fBinary files /dev/null and b/packages/twenty-docs/images/user-guide/email-campaigns/unsubscribers-tab.png differdiff --git a/packages/twenty-docs/navigation/base-structure.json b/packages/twenty-docs/navigation/base-structure.jsonindex 5c405bcf939..2feb243561c 100644--- a/packages/twenty-docs/navigation/base-structure.json+++ b/packages/twenty-docs/navigation/base-structure.json@@ -133,6 +133,25 @@}]},+ {+ "key": "emailCampaigns",+ "label": "Email Campaigns",+ "icon": "paper-plane",+ "pages": [+ "user-guide/email-campaigns/overview",+ {+ "key": "emailCampaignsHowTos",+ "label": "How-Tos",+ "pages": [+ "user-guide/email-campaigns/how-tos/set-up-a-sending-domain",+ "user-guide/email-campaigns/how-tos/email-campaign-best-practices",+ "user-guide/email-campaigns/how-tos/send-your-first-campaign",+ "user-guide/email-campaigns/how-tos/create-a-campaign-with-ai",+ "user-guide/email-campaigns/how-tos/manage-unsubscribes-and-topics"+ ]+ }+ ]+ },{"key": "workflows","label": "Workflows",diff --git a/packages/twenty-docs/navigation/navigation.template.json b/packages/twenty-docs/navigation/navigation.template.jsonindex 4c3b085b0e3..537cda66109 100644--- a/packages/twenty-docs/navigation/navigation.template.json+++ b/packages/twenty-docs/navigation/navigation.template.json@@ -50,6 +50,14 @@}}},+ "emailCampaigns": {+ "label": "Email Campaigns",+ "groups": {+ "emailCampaignsHowTos": {+ "label": "How-Tos"+ }+ }+ },"workflows": {"label": "Workflows","groups": {diff --git a/packages/twenty-docs/user-guide/email-campaigns/how-tos/create-a-campaign-with-ai.mdx b/packages/twenty-docs/user-guide/email-campaigns/how-tos/create-a-campaign-with-ai.mdxnew file mode 100644index 00000000000..8f5a11f11df--- /dev/null+++ b/packages/twenty-docs/user-guide/email-campaigns/how-tos/create-a-campaign-with-ai.mdx@@ -0,0 +1,118 @@+---+title: Use AI for Sales Campaigns+description: Use AI and workflows to build focused sales lists and draft the campaign.+---++AI is useful when you have a sales goal but do not want to start with a blank list or blank email. Tell it what you are trying to do. It can look through your CRM, build a focused list, and draft one campaign for that list. You review the work, send a test, then decide whether to send it.++<Note>+ AI can prepare a campaign, but it cannot send one. Sending is always your+ decision.+</Note>++<Note>+ Campaigns are one-to-many. AI creates one draft with one subject and one email+ body for the selected list; it does not write a separate draft for each lead.+</Note>++## What AI can help with++| Task | Example |+| ---------------------- | ------------------------------------------------------------------------------------------ |+| **Find people** | "Find decision makers at software companies in Germany with a Head or VP title." |+| **Build a list** | "Create a list for open opportunities in the healthcare industry." |+| **Draft the campaign** | Write the subject, copy, call to action, and personalization for the sales play. |+| **Personalize** | Add variables such as `{{name.firstName}}` so the campaign includes that value when it sends. |+| **Improve a draft** | "Make this more direct", "Add a demo CTA", or "Give me three subject lines." |++The AI follows your permissions. It can only see and change records your role can access.++## Pair AI with workflows++AI helps you decide what to say and who to say it to. Workflows keep the data and lists ready for the next campaign.++Lists and List Members are records in Twenty. A workflow can create or update them as your CRM changes. This gives you a repeatable way to build sales segments instead of starting from scratch each time.++| Sales play | What the workflow does | Where AI helps |+| --- | --- | --- |+| **New ICP leads** | When a new lead matches your criteria, add them to an outbound list. | Draft one campaign for that segment. |+| **Stalled opportunities** | Find deals that have been idle for a set time and build a follow-up list. | Draft one campaign for the selected follow-up list. |+| **Account expansion** | Add contacts when an account reaches a renewal date, plan change, or other milestone. | Draft one campaign for the renewal or expansion list. |++Workflows prepare or refresh the list. AI can research the CRM data and draft one campaign for that list. You still review the audience and choose when to send.++See [Workflows](/user-guide/workflows/overview) to build the automation behind a sales play.++## Part 1: Open the AI++Press `@` anywhere in Twenty, or press `Cmd+K` (`Ctrl+K` on Windows) and choose **Ask AI**.++## Part 2: Build your audience++Tell the AI who should receive the email. Use the fields in your workspace, just as you would when speaking to a teammate.++> Create a list called "Q4 product update" with everyone at companies that have more than 50 employees and are in the healthcare industry.++The AI searches your records, creates the list, and adds the people it finds. Open the list and check the members before you send.++<Warning>+ Only add people who agreed to receive your emails. Your CRM can include people+ you have only exchanged emails with. See+ [Email campaign best+ practices](/user-guide/email-campaigns/how-tos/email-campaign-best-practices).+</Warning>++## Part 3: Write the campaign++Tell the AI the goal, key points, tone, and call to action you need.++> Write a follow-up for people at open opportunities in the healthcare industry. Keep the subject under 50 characters. Start with a short, friendly intro that greets each person by first name, name three reasons the reporting dashboard can help their team, and end with a "Book a demo" button linking to https://example.com/demo.++The AI creates a draft with a name, subject, and email body. Open it from **Campaigns** to review it in the editor.++<img+ src="/images/user-guide/email-campaigns/ai-chat-campaign.png"+ style={{ width: '50%' }}+/>++To make changes, keep chatting. Open the campaign first so the AI knows which one you mean:++- "Make the tone more direct."+- "Shorten the intro to two sentences."+- "Replace the button text with Book a demo."+- "Suggest three other subject lines."++You can edit the draft yourself at any time.++## Part 4: Review and send++<img+ src="/images/user-guide/email-campaigns/campaign-composer.png"+ style={{ width: '100%' }}+/>++AI writes the draft. You choose the sender, audience, and send time:++1. Open the campaign's **Email** tab.+2. Choose the **From** address, the list under **To** and, optionally, an **Unsubscribe topic**.+3. Read the email. Check the facts, links, and prices.+4. Click **Test** and send yourself a copy.+5. Click **Send**, then choose **Send now** or **Send later**.++Each step is covered in detail in [Send your first campaign](/user-guide/email-campaigns/how-tos/send-your-first-campaign).++## Tips for good prompts++- **Use the field name.** "People at companies in the healthcare industry" is clearer than "healthcare leads."+- **Give it the facts.** It does not know your offer, price, or sales motion unless you tell it or the information is in your CRM.+- **Give it a job.** Say who this is for, what you want them to do, and why it matters to them.+- **Ask for options.** Try three subject lines or two versions of the same message for different segments.+- **Check the list size.** Ask "How many people are in the Q4 product update list?" before you send.++## Limitations++- The AI can only edit campaigns that are still **Draft**.+- Unsubscribe topics and the unsubscribe list are managed in **Settings**, not through the AI. See [Manage unsubscribes and topics](/user-guide/email-campaigns/how-tos/manage-unsubscribes-and-topics).+- AI can get facts wrong. Always read the email before you send it.++See [AI Chatbot](/user-guide/ai/capabilities/ai-chatbot) for more on what the AI can do across your workspace.diff --git a/packages/twenty-docs/user-guide/email-campaigns/how-tos/email-campaign-best-practices.mdx b/packages/twenty-docs/user-guide/email-campaigns/how-tos/email-campaign-best-practices.mdxnew file mode 100644index 00000000000..87d78938e2f--- /dev/null+++ b/packages/twenty-docs/user-guide/email-campaigns/how-tos/email-campaign-best-practices.mdx@@ -0,0 +1,88 @@+---+title: Email Campaign Best Practices+description: Send emails people expect and keep your domain in good standing.+---++Email providers look at who you send to and how they react. Send useful emails to people who expect them and you are more likely to reach the inbox. Send to a bought or stale list and you are more likely to land in spam. Too many spam reports can pause sending from your domain.++Here is what Twenty handles, what your team needs to do, and the numbers worth watching.++## What Twenty handles for you++- **Domain checks**: after you [verify your sending domain](/user-guide/email-campaigns/how-tos/set-up-a-sending-domain), every campaign is signed with DKIM and passes SPF on your domain.+- **Unsubscribes**: every campaign includes an unsubscribe link and the one-click unsubscribe headers Gmail and Yahoo require. Opt-outs take effect right away.+- **No-repeat list**: people who bounce, report spam, or unsubscribe are skipped in later campaigns.+- **No duplicates**: each person gets one email, even if they appear twice in a list.++## What is up to you++Twenty cannot know how you got a person's email address or what your postal address is. Your team needs to get those right.++### Do++- **Only email people who agreed to hear from you.** They signed up, bought from you, or gave you permission. Keep a record of when and how.+- **Include your postal address.** US law (CAN-SPAM) requires a physical address in every marketing email. Add it to the bottom of your campaign.+- **Start small with a new domain.** Send first to your most engaged contacts, then grow the volume over a few weeks. See [Warm up a new domain](#warm-up-a-new-domain).+- **Use a recognizable sender.** Keep the same **From** address and display name from one campaign to the next, so recipients know who you are.+- **Write a subject line that matches the content.** Misleading subject lines are illegal in many countries and drive spam reports everywhere.+- **Clean your lists.** Stop emailing people who have not replied, bought, or signed in for six to twelve months.+- **Send a test first.** Check the layout, the links and the sender before every campaign.+- **Use unsubscribe topics.** Let people leave one kind of email, such as a newsletter, without leaving every list. See [Manage unsubscribes and topics](/user-guide/email-campaigns/how-tos/manage-unsubscribes-and-topics).++### Don't++- **Don't buy, rent, or scrape lists.** They often contain spam traps: addresses used to catch senders who never had permission. A few can hurt your domain.+- **Don't email everyone in your CRM.** Twenty can create people from synced email and calendars. An email exchange is not permission to send marketing.+- **Don't send a huge campaign from a new domain.** A sudden jump in volume looks like spam, even when your list is clean.+- **Don't use one big image as the email.** Emails with mostly images and little text are more likely to be filtered. Use real text for the message.+- **Don't use public link shorteners** such as bit.ly. Spammers use them to hide links, so filters are wary of them.+- **Don't add back people who unsubscribed or reported spam.** Twenty blocks them for a reason.++<Note>+ There is no magic list of words that makes an email spam. Providers care much+ more about your domain's reputation and how people react to your email.+</Note>++## Numbers to watch++After each campaign, compare the **Bounced count** and **Complained count** with the **Sent count**.++| Measure | Aim for | Why it matters |+| ------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------- |+| Spam complaint rate | Below 0.1% | Gmail asks bulk senders to stay under 0.1% and never reach 0.3%. Above that, mail is rejected or sent to spam. |+| Bounce rate | Below 2% | A high bounce rate means the list is out of date. At 5% or more, your email provider starts reviewing your sending. |++A complaint rate of 0.1% is one spam report for every 1,000 emails. If you see more, pause and look at your audience before the next campaign.++<Warning>+ If too many people bounce or mark your emails as spam, sending from your+ domain can be paused.+</Warning>++## Warm up a new domain++Providers trust a domain that builds volume steadily. A new domain that suddenly sends a large campaign looks risky. If your domain has never sent campaigns:++| Stage | What to send |+| ------------------- | ------------------------------------------------------------------------------------ |+| First week | 50 to 100 emails a day, to your most engaged contacts |+| Weeks two and three | Roughly double the volume every few days, as long as bounces and complaints stay low |+| Weeks four to six | Reach your normal volume, then keep it steady from one send to the next |++Split a large list into smaller lists and send in stages. Your workspace can send up to 1,000 campaign emails a day.++## Laws to know++This is general guidance, not legal advice.++- **United States (CAN-SPAM)**: include a postal address, working unsubscribe link, and honest subject line. Opt-outs must be honored within 10 business days. Twenty handles them right away.+- **European Union and United Kingdom (GDPR, ePrivacy, PECR)**: marketing email usually needs prior consent. You need to show when and how you got it.+- **Canada (CASL)**: you need express or implied consent before sending and must be able to prove it.++## Further reading++- [Gmail email sender guidelines](https://support.google.com/a/answer/81126)+- [Yahoo sender best practices](https://senders.yahooinc.com/best-practices/)+- [Microsoft requirements for high-volume senders](https://techcommunity.microsoft.com/blog/microsoftdefenderforoffice365blog/strengthening-email-ecosystem-outlook%E2%80%99s-new-requirements-for-high%E2%80%90volume-senders/4399730)+- [CAN-SPAM Act compliance guide](https://www.ftc.gov/business-guidance/resources/can-spam-act-compliance-guide-business)+- [Google Postmaster Tools](https://postmaster.google.com), to watch your domain's reputation at Gmaildiff --git a/packages/twenty-docs/user-guide/email-campaigns/how-tos/manage-unsubscribes-and-topics.mdx b/packages/twenty-docs/user-guide/email-campaigns/how-tos/manage-unsubscribes-and-topics.mdxnew file mode 100644index 00000000000..f7e20c2ae6f--- /dev/null+++ b/packages/twenty-docs/user-guide/email-campaigns/how-tos/manage-unsubscribes-and-topics.mdx@@ -0,0 +1,115 @@+---+title: Manage Unsubscribes and Topics+description: See who opted out and let people choose which updates they receive.+---++Every campaign includes an unsubscribe link. Twenty keeps track of who uses it. Topics give people a little more control: they can leave your newsletter while still receiving product updates.++## How unsubscribing works++Every campaign email includes:++- A line in the footer: "Don't want these emails? Unsubscribe."+- The one-click unsubscribe headers that Gmail, Yahoo and other email apps use to show their own **Unsubscribe** button.++The link opens an unsubscribe page on your domain, for example `unsubscribe.yourcompany.com`:++- **No public topics**: people see one **Unsubscribe** button.+- **Public topics**: people see one checkbox for each topic. They can untick topics and click **Update**, or click **Unsubscribe all**.++An unsubscribe takes effect right away. Twenty skips that person in later campaigns.++<img+ src="/images/user-guide/email-campaigns/unsubscribe-page-preview.png"+ style={{ width: '100%' }}+/>++<Note>+ The unsubscribe button in Gmail, Yahoo, and other email apps removes a person+ from all your campaigns, not just the topic in the email they received.+</Note>++## Part 1: Create topics++Topics are types of email, such as **Newsletter**, **Product updates**, or **Events**.++1. Go to **Settings → Communication**.+2. Under **Unsubscribe**, click **Manage unsubscribe**.+3. Open the **Topics** tab and click **Add topic**.+4. In **Name**, enter the name people see, for example `Newsletter`.+5. In **Description**, you can explain the emails for your team.+6. Turn on **Listed on the unsubscribe page** to show the topic to recipients.+7. Click **Save**.++| Visibility | Behavior |+| ----------- | ----------------------------------------------------------------------------------------------------- |+| **Public** | People see the topic on the unsubscribe page and can leave it on its own. |+| **Private** | People never see it. Use it to group campaigns for your team. It still respects opt-outs. |++New topics are private until you turn on **Listed on the unsubscribe page**.++<img+ src="/images/user-guide/email-campaigns/new-topic-form.png"+ style={{ width: '100%' }}+/>++## Part 2: Use a topic in a campaign++In the campaign's **Email** tab, choose a topic under **Unsubscribe topic**. The field appears after you create your first topic.++When the campaign sends, Twenty skips:++- People who unsubscribed from this topic.+- People who unsubscribed from everything.++People who only left a different topic still receive it.++## Part 3: See who unsubscribed++1. Go to **Settings → Communication**.+2. Under **Unsubscribe**, click **Manage unsubscribe**.+3. Open the **Unsubscribers** tab.++The list shows every address that no longer receives campaigns:++| Column | What it shows |+| ----------------- | ------------------------------------------------------------------------------------------------------------- |+| **Email address** | The address Twenty skips. |+| **Scope** | **All emails**, or the topic they left. |+| **Reason** | **Unsubscribed**, **Bounce** (the address does not exist), or **Complaint** (they reported the email as spam). |+| **Date** | When it happened. |++Use search and filters to find an address, reason, or topic.++<img+ src="/images/user-guide/email-campaigns/unsubscribers-tab.png"+ style={{ width: '100%' }}+/>++<Warning>+ Bounces and spam complaints are permanent. Sending to those addresses again+ can hurt your domain's reputation, so Twenty does not allow it.+</Warning>++## Preview the unsubscribe page++The **Unsubscribe page** tab shows what people see with your current public topics. Nothing is saved in the preview.++## Troubleshooting++<Accordion title="Recipients only see an Unsubscribe button, not my topics">+ Only public topics appear on the unsubscribe page. Open the topic and turn on+ **Listed on the unsubscribe page**.+</Accordion>++<Accordion title="Someone unsubscribed from one topic but stopped receiving everything">+ They may have used the unsubscribe button in their email app, which removes+ them from all campaigns. Only the link in the email footer lets them choose+ specific topics.+</Accordion>++<Accordion title="A person was skipped but they want to receive emails again">+ If you have public topics, they can open the unsubscribe link in an email+ from the last 30 days, tick the topics they want, and click **Update**.+ Bounces and spam complaints cannot be undone.+</Accordion>diff --git a/packages/twenty-docs/user-guide/email-campaigns/how-tos/send-your-first-campaign.mdx b/packages/twenty-docs/user-guide/email-campaigns/how-tos/send-your-first-campaign.mdxnew file mode 100644index 00000000000..8d3e3710035--- /dev/null+++ b/packages/twenty-docs/user-guide/email-campaigns/how-tos/send-your-first-campaign.mdx@@ -0,0 +1,211 @@+---+title: Send Your First Campaign+description: Build your list, write the email, test it, then send or schedule it.+---++Start with a list of people who expect to hear from you. Write the email, send yourself a test, then send it now or schedule it for later.++<Tip>+ AI can help with this: it can build the list and draft the email.+ See [Create a campaign with+ AI](/user-guide/email-campaigns/how-tos/create-a-campaign-with-ai).+</Tip>++## Before you start++Before you start, make sure you have:++- **A verified sending domain.** See [Set up a sending domain](/user-guide/email-campaigns/how-tos/set-up-a-sending-domain).+- **The Workspace settings permission** to test, schedule, and send campaigns.+- **Email credits** if you use Twenty Cloud. Each sent email uses credits. See [Credits](/user-guide/billing/capabilities/credits).++## Part 1: Build a list++Make a list of the people who should receive this email.++1. Press `Cmd+K` (`Ctrl+K` on Windows) and search for **Go to Lists**.+2. Click **New List** and give the list a name, for example `Newsletter subscribers`.+3. Open the list and use the **Members** field to add people.++<img+ src="/images/user-guide/email-campaigns/list-members.png"+ style={{ width: '100%' }}+/>++You can also add one person from their record with the **Lists** field.++<Note>+ Twenty sends to each person's primary email address. It skips people without+ an address and people who unsubscribed, bounced, or reported spam.+</Note>++## Part 2: Create the campaign++1. Press `Cmd+K` and choose **Compose Campaign**, or open **Campaigns** and click **New Campaign**.+2. Give the campaign a name. Only your team sees this name.+3. Open the **Email** tab and fill in the envelope:+ - **From**: the address people see as the sender. It lists your email channels.+ - **To**: the list from Part 1. You can also make a new list here.+ - **Unsubscribe topic**: optional. Choose a topic so people can leave this type of email without leaving every list. This field appears after you create a topic. See [Manage unsubscribes and topics](/user-guide/email-campaigns/how-tos/manage-unsubscribes-and-topics).+ - **Subject**: the subject line people see in their inbox.++<img+ src="/images/user-guide/email-campaigns/campaign-composer.png"+ style={{ width: '100%' }}+/>++## Part 3: Write the email++Write your email in the editor below the subject. Twenty saves the draft as you go.++- Type `/` to see commands, or use the left rail to add **Text**, **Image**, **Blocks**, and **Variables**.+- **Blocks** include **Section**, **2 Columns**, **3 Columns**, **Button**, **Divider**, **Image** and **HTML**, for pasting your own HTML.++### Personalize with variables++Variables are replaced with each person's details when the campaign sends. Insert one from **Variables**, or type it in double curly braces:++| Variable | Replaced with |+| -------------------- | ------------- |+| `{{name.firstName}}` | First name |+| `{{name.lastName}}` | Last name |+| `{{fullName}}` | Full name |+| `{{jobTitle}}` | Job title |++You can also use text, number, date, and select fields from People, including custom fields. Variables work in the subject line, body, and link addresses.++For example, `Hi {{name.firstName}},` becomes `Hi Ana,` for Ana.++<img+ src="/images/user-guide/email-campaigns/campaign-variables.png"+ style={{ width: '100%' }}+/>++<Warning>+ If a person has no value for a variable, Twenty leaves it empty.+ `Hi {{name.firstName}},` becomes `Hi ,` when a person has no first name.+ Check your list, or write a greeting that still works.+</Warning>++Twenty does not add your company's postal address. Add it to the bottom of the email; US law requires it in marketing emails.++## Part 4: Send a test++1. Click **Test** at the top of the campaign, or press `Cmd+K` and choose **Send Test Email**.+2. In **Recipient**, type your own address.+3. Click **Send test email**.++<img+ src="/images/user-guide/email-campaigns/campaign-send-test.png"+ style={{ width: '100%' }}+/>++Check the layout, links, and sender in your inbox, on desktop and on your phone.++<Note>+ Variables are empty in test emails because a test is not sent to a specific+ person. Your workspace can send three test emails a day.+</Note>++## Part 5: Send or schedule++1. Click **Send** at the top of the campaign, or press `Cmd+K` and choose **Send Campaign**.+2. Check the summary. **Recipients** shows how many people will receive the email and why others are skipped, such as no email address or an unsubscribe.+3. Under **Delivery**, choose:+ - **Send now**: starts right away and cannot be undone.+ - **Send later**: choose a date and time in **Send at**.+4. Click **Send campaign** or **Schedule campaign**.++<img+ src="/images/user-guide/email-campaigns/campaign-send-panel.png"+ style={{ width: '50%' }}+/>++To move a scheduled campaign, click **Send** again, choose a new time in **Send at**, and click **Reschedule campaign**. Twenty counts recipients again when it sends, so the number can change.++<img+ src="/images/user-guide/email-campaigns/campaign-schedule-panel.png"+ style={{ width: '50%' }}+/>++Your workspace can send up to 1,000 campaign emails a day. Need more? Contact us via chat to request a higher limit.++<Note>+ Twenty checks a scheduled campaign again when it is time to send. If nobody+ can receive it or the sending domain is no longer verified, it goes back to+ **Draft** instead of sending.+</Note>++## After you send++The campaign's **Status** tells you where it is:++<img+ src="/images/user-guide/email-campaigns/campaigns-list.png"+ style={{ width: '100%' }}+/>++| Status | Meaning |+| -------------------- | ------------------------------------------------------------------------------------ |+| **Draft** | Not sent yet. You can edit it. |+| **Scheduled** | Waiting for its send time. |+| **Sending** | Emails are going out. |+| **Sent** | Every email was sent to the delivery provider. |+| **Sent with errors** | Some emails could not be sent, for example because the workspace ran out of credits. |+| **Canceled** | Stopped before it finished. |++The **Home** tab shows sent, delivered, bounced, complained, failed, and skipped counts. The **Recipients** list shows who the campaign went to.++<img+ src="/images/user-guide/email-campaigns/campaign-sent-results.png"+ style={{ width: '100%' }}+/>++To send a similar campaign later, click **Duplicate**. Twenty copies the email, list, and settings into a new draft.++### Cancel a campaign++Click **Cancel** at the top of the campaign, or press `Cmd+K` and choose **Cancel Campaign**:++- **Scheduled**: nothing has gone out. Confirm with **Unschedule Campaign**. The campaign returns to drafts, and you can edit or schedule it again.+- **Sending**: emails still waiting are stopped. You cannot recall emails already sent.++## Troubleshooting++<Accordion title="The From field has no addresses">+ **From** lists your email channels. Create an email channel first, then verify+ its domain. See [Set up a sending+ domain](/user-guide/email-campaigns/how-tos/set-up-a-sending-domain).+</Accordion>++<Accordion title="Sending fails with No verified sending domain matches this from address">+ The **From** address is on a domain that is not verified yet. Finish the steps+ in [Set up a sending+ domain](/user-guide/email-campaigns/how-tos/set-up-a-sending-domain), or+ choose another address.+</Accordion>++<Accordion title="Send campaign is greyed out">+ The campaign needs a **From** address, a list, a subject and a body, and at+ least one person who can receive it. Check the **Recipients** summary for+ people who are skipped. With **Send later**, the send time must also be in the+ future.+</Accordion>++<Accordion title="Sending fails with This campaign cannot be sent">+ Check that the campaign has a **From** address, a list and a subject. Then+ check the variables: a variable that does not match a field on People blocks+ sending. Insert variables from **Variables** rather than typing them, and use+ `{{name.firstName}}`, not `{{firstName}}`.+</Accordion>++<Accordion title="A scheduled campaign went back to Draft">+ When it was time to send, the campaign could not go out, for example because+ no one on the list could receive it or the domain was no longer verified. Fix+ the cause, then schedule it again.+</Accordion>++<Accordion title="I can't find Campaigns">+ Email campaigns may not be turned on for your workspace yet. Contact us via+ chat to enable them.+</Accordion>diff --git a/packages/twenty-docs/user-guide/email-campaigns/how-tos/set-up-a-sending-domain.mdx b/packages/twenty-docs/user-guide/email-campaigns/how-tos/set-up-a-sending-domain.mdxnew file mode 100644index 00000000000..c7de2497eec--- /dev/null+++ b/packages/twenty-docs/user-guide/email-campaigns/how-tos/set-up-a-sending-domain.mdx@@ -0,0 +1,167 @@+---+title: Set Up a Sending Domain+description: Verify your domain so you can send campaigns from your own address.+---++Campaigns come from an address on your domain, such as `[email protected]`. Before Twenty can send from it, Gmail, Outlook, and other providers need proof that you own the domain. You add that proof as DNS records where your domain is managed.++You will create the address in Twenty, add the DNS records, then verify them.++<Note>+ Twenty's records use their own host names, such as+ `twenty-bounce.yourcompany.com` and `unsubscribe.yourcompany.com`. They do not+ change the records your day-to-day email relies on, so you can use your main+ domain. The only exception is DMARC, which applies to the whole domain.+ Twenty suggests it only when you do not already have one.+</Note>++## Before you start++Before you start, make sure you have:++- **Access to your DNS provider**: the company where you manage your domain records, such as Cloudflare, GoDaddy, or Namecheap. This is not always the company you bought the domain from.+- **The Workspace settings permission** in Twenty.++## Part 1: Create the address in Twenty++The sending domain comes from an email channel. If you already set up a shared inbox in Twenty, the domain is already there. Skip to Part 2.++1. Go to **Settings → Communication**.+2. Click **Add email channel**.++<img+ src="/images/user-guide/email-campaigns/channels-list.png"+ style={{ width: '100%' }}+/>++3. In **Source Email Address**, enter the address you want to use, for example `[email protected]`. Twenty uses the part after `@` as the sending domain.+4. In **Display Name**, enter the name people see in their inbox, for example `Acme Newsletter`.+5. Click **Save**.++<img+ src="/images/user-guide/email-campaigns/new-channel-form.png"+ style={{ width: '100%' }}+/>++Twenty opens the channel. Scroll to **Sending domain**. It lists the DNS records you need, with a copy button next to each value.++<img+ src="/images/user-guide/email-campaigns/sending-domain-records.png"+ style={{ width: '100%' }}+/>++<Note>+ A domain can only be verified in one Twenty workspace. Twenty tells you if it+ is already being used elsewhere.+</Note>++## Part 2: Understand the records++| Group | Records | What it does |+| ------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |+| **Domain authentication** | Three `CNAME` records ending in `._domainkey`, plus an `MX` and a `TXT` record on `twenty-bounce` | Shows that Twenty can send for your domain (DKIM and SPF). The `twenty-bounce` records also send bounce reports back to Twenty. |+| **DMARC policy** | One `TXT` record on `_dmarc` | Tells providers what to do with mail that fails the checks. Twenty only lists it if you do not have a DMARC record. |+| **Unsubscribe link** | Two `CNAME` records, on `unsubscribe` and `_acme-challenge.unsubscribe` | Hosts the unsubscribe page on your domain, for example `unsubscribe.yourcompany.com`. You cannot send campaigns until this is verified. |++Add every record Twenty shows. Gmail, Yahoo, and Outlook reject bulk email that is not authenticated.++<Warning>+ If your domain already has a DMARC record, keep it. Do not add another one:+ providers treat two DMARC records as if you had none.+</Warning>++## Part 3: Add the records at your DNS provider++For each record, add a new entry at your DNS provider and copy these values from Twenty:++- **Type**: `CNAME`, `MX` or `TXT`.+- **Name**: sometimes called **Host**.+- **Value**: sometimes called **Target**, **Points to**, **Content**, or **Answer**.++For the `MX` record, Twenty shows the priority before the value, such as `10 feedback-smtp.eu-central-1.amazonses.com`. Most providers have a separate **Priority** field. Put `10` there and the rest in the value.++<Warning>+ Many providers add your domain to the end of **Name** automatically. If yours+ does, enter only the part before your domain. For+ `twenty-bounce.yourcompany.com`, enter `twenty-bounce`. Otherwise the record+ becomes `twenty-bounce.yourcompany.com.yourcompany.com` and will not verify.+</Warning>++Follow your provider's instructions, using the values from Twenty:++| Provider | Their guide | Watch out for |+| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |+| Amazon Route 53 | [Working with records](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/rrsets-working-with.html) | Wrap `TXT` values in double quotes. |+| Azure DNS | [Manage DNS records](https://learn.microsoft.com/en-us/azure/dns/dns-getstarted-portal) | Only works if the domain uses Azure's name servers. |+| Bluehost | [Add, edit or delete DNS entries](https://www.bluehost.com/help/article/dns-management-add-edit-or-delete-dns-entries) | Enter only the host part in **Host Record**. |+| Cloudflare | [Create DNS records](https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/) | Set every `CNAME` to **DNS only** (grey cloud). A proxied record never verifies. |+| DigitalOcean | [Manage DNS records](https://docs.digitalocean.com/products/networking/dns/how-to/manage-records/) | Only works if the domain uses DigitalOcean's name servers. |+| Gandi | [DNS records](https://docs.gandi.net/en/domain_names/common_operations/dns_records.html) | End `CNAME` values with a dot, as in `abc.dkim.amazonses.com.` |+| GoDaddy | [Add a CNAME record](https://www.godaddy.com/help/add-a-cname-record-19236) | Enter only the host part in **Name**. GoDaddy adds your domain itself. |+| Google Cloud DNS | [Manage records](https://cloud.google.com/dns/docs/records) | Only works if the domain uses Google Cloud's name servers. |+| Hostinger | [Manage DNS records](https://www.hostinger.com/support/1583249-how-to-manage-dns-records-at-hostinger/) | Only works if the domain uses Hostinger's name servers. |+| Hover | [Edit DNS records](https://help.hover.com/hc/en-us/articles/217282457-how-to-edit-dns-records-a-aaaa-cname-mx-txt-srv-) | Enter only the host part in **Hostname**. |+| IONOS | [Manage DNS settings](https://www.ionos.com/help/domains/general-information-about-dns-settings/managing-dns-settings-in-control-center/) | Enter only the host part in **Host name**. |+| Name.com | [Add a CNAME record](https://www.name.com/support/articles/115004895548-adding-a-cname-record) | Enter only the host part in **Host**. |+| Namecheap | [Add TXT, SPF, DKIM and DMARC records](https://www.namecheap.com/support/knowledgebase/article.aspx/317/2237/how-do-i-add-txtspfdkimdmarc-records-for-my-domain/) | Only works if the domain uses Namecheap BasicDNS, FreeDNS or PremiumDNS. Enter only the host part. |+| Netlify | [DNS records](https://docs.netlify.com/manage/domains/configure-domains/dns-records/) | Only works if the domain uses Netlify's name servers. |+| Network Solutions | [Manage Advanced DNS records](https://www.networksolutions.com/help/article/manage-dns-adns-records) | Enter only the host part. |+| OVHcloud | [Create a CNAME record](https://docs.ovhcloud.com/en/guides/web-cloud/domains/dns-zone-cname-record-creation) | Enter only the host part in **Subdomain**. |+| Porkbun | [Edit DNS records](https://kb.porkbun.com/article/68-how-to-edit-dns-records) | Enter only the host part in **Host**. |+| Squarespace Domains | [Edit your domain's DNS records](https://support.squarespace.com/hc/en-us/articles/360002101888-Edit-your-domain-s-DNS-records) | Squarespace blocks a record that conflicts with an existing one instead of replacing it. |+| Vercel | [Manage DNS records](https://vercel.com/docs/domains/managing-dns-records) | Only works if the domain uses Vercel's name servers. Otherwise, add the records where your DNS is hosted. |+| Wix | [Manage DNS records](https://support.wix.com/en/article/managing-dns-records-in-your-wix-account) | Only works if the domain uses Wix's name servers. Otherwise, add the records where your DNS is hosted. |++If your provider is not listed, look for **DNS**, **DNS records**, **Zone editor**, or **Advanced DNS** in your domain settings.++## Part 4: Verify++Twenty checks your records every hour. To check now, click **Check verification** in **Sending domain**.++DNS changes usually work within an hour, but some providers take up to 48 hours. The domain moves from **Pending** to **Verified** when Twenty finds the authentication records. The **Unsubscribe link** also needs to show **Verified** before you can send campaigns.++<img+ src="/images/user-guide/email-campaigns/sending-domain-verified.png"+ style={{ width: '100%' }}+/>++The **DMARC policy** row always shows **Not set**. That is expected: Twenty suggests the record but does not check it.++## Troubleshooting++<Accordion title="The domain stays Pending for hours">+ Open your DNS provider and compare each **Name** with the value in Twenty.+ The usual problem is that the provider added your domain a second time, as+ described in Part 3. Also check that you added the records where your DNS is+ actually hosted. Records in your registrar's panel do nothing if your name+ servers point somewhere else.+</Accordion>++<Accordion title="Cloudflare: the records are there but never verify">+ Set every `CNAME` to **DNS only**. With the orange cloud on, Cloudflare+ returns its own servers instead of the value Twenty gave you.+</Accordion>++<Accordion title="The domain shows Failed">+ Twenty stops checking a failed domain. Fix the records, then click **Check+ verification**.+</Accordion>++<Accordion title="The domain shows Temporary Failure">+ Your DNS provider did not answer when Twenty checked. Twenty keeps checking+ every hour, so this usually fixes itself.+</Accordion>++<Accordion title="Authentication is verified but the Unsubscribe link stays Pending">+ The two unsubscribe records are checked separately and can take longer because+ Twenty also creates a secure certificate for them. Check that both `CNAME`+ records exist—on `unsubscribe` and `_acme-challenge.unsubscribe`—then wait up+ to an hour.+</Accordion>++<Accordion title="My provider rejects the MX record">+ Put `10` in **Priority** and only the host name in the value, such as+ `feedback-smtp.eu-central-1.amazonses.com`. Do not put `10` in the value.+</Accordion>++Next, read the [best practices](/user-guide/email-campaigns/how-tos/email-campaign-best-practices), then [send your first campaign](/user-guide/email-campaigns/how-tos/send-your-first-campaign).diff --git a/packages/twenty-docs/user-guide/email-campaigns/overview.mdx b/packages/twenty-docs/user-guide/email-campaigns/overview.mdxnew file mode 100644index 00000000000..cd592aed761--- /dev/null+++ b/packages/twenty-docs/user-guide/email-campaigns/overview.mdx@@ -0,0 +1,80 @@+---+title: Email Campaigns+description: Use the CRM data, workflows, and reporting your sales team already relies on.+---++<Warning>+**Beta Feature**: Email campaigns are in beta. Contact us via chat to enable them for your workspace.+</Warning>++Your sales team already works from Twenty. Your accounts, people, pipeline, activity, and custom data are here. Campaigns lets you act on that data without exporting it to a separate marketing tool.++Campaigns are one-to-many. You create one email for a focused list, not a separate draft for every lead. Fields such as a person's first name can still be filled in when the campaign sends.++<img+ src="/images/user-guide/email-campaigns/campaigns-list.png"+ style={{ width: '100%' }}+/>++## Campaigns for sales teams++Use campaigns to run sales plays that would be hard to manage one email at a time:++- **Work target accounts.** Reach the right people at companies in a specific industry, region, size, or account tier.+- **Move stalled deals.** Send a useful follow-up to people linked to opportunities that have been sitting too long.+- **Run event and outbound plays.** Invite the people who match your ideal customer profile, not every contact in your database.+- **Grow existing accounts.** Reach customers based on their plan, usage, renewal date, or any custom field your team tracks.++## Use the CRM work you have already done++### Build better segments++Build a list from the data your team already maintains: account owner, deal stage, industry, last activity, product plan, lead score, or your own custom fields. No CSV export. No upload. No second contact database to keep in sync.++### See the signal, then act on it++Use custom dashboards, charts, and funnels to spot where revenue is getting stuck. Then build a focused campaign around that signal. Campaigns turn a report your team sees into a next step your team can take.++### Keep the work moving with workflows++Workflows can create and update Lists and List Members as records change. For example, add new people who match your ideal customer profile to an outbound list, or move contacts into a follow-up list when a deal reaches a certain stage. Your campaign audience can keep up with the way your sales team works.++See [Workflows](/user-guide/workflows/overview) to build automations around your sales process.++### Use AI when it saves time++Ask Twenty's AI to find the right people, make a list, or draft one campaign for a list. It uses the CRM data it can access and follows your workspace permissions. It prepares the work; your team reviews it and decides whether to send.++See [Create a campaign with AI](/user-guide/email-campaigns/how-tos/create-a-campaign-with-ai) for the full workflow.++### Keep results close to the work++After you send, the campaign shows who received it, what bounced, what was skipped, and whether anyone marked it as spam. Use that information when you plan the next play.++## Send from your own domain++Campaigns come from an address on your domain, so people know who sent them. Twenty walks you through domain verification and puts the unsubscribe page on your domain too.++Your workspace can send up to 1,000 campaign emails a day. Need a higher limit? Contact us via chat. We review each request and raise limits case by case.++## Get started++Set up your sending domain once. Then start with a small group of people who expect to hear from you.++<CardGroup cols={2}>+ <Card title="Set up your sending domain" icon="globe" href="/user-guide/email-campaigns/how-tos/set-up-a-sending-domain">+ Verify your domain and send from an address people recognize.+ </Card>+ <Card title="Send your first campaign" icon="paper-plane" href="/user-guide/email-campaigns/how-tos/send-your-first-campaign">+ Build the list, write the email, test it, and send when you are ready.+ </Card>+</CardGroup>++<CardGroup cols={2}>+ <Card title="Create a campaign with AI" icon="wand-magic-sparkles" href="/user-guide/email-campaigns/how-tos/create-a-campaign-with-ai">+ Ask AI to build the list and draft the email, then review it yourself.+ </Card>+ <Card title="Campaign best practices" icon="list" href="/user-guide/email-campaigns/how-tos/email-campaign-best-practices">+ Learn how to keep your emails welcome in the inbox.+ </Card>+</CardGroup>