{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Sending Newsletters","type":"basic","slug":"sending-newsletters","excerpt":"","body":"Telescope comes with a built-in email newsletter package that sends a daily or weekly newsletter through [MailChimp](http://mailchimp.com).  \n\nNote that this section refers specifically to sending this automated newsletter. For in-app emails (such as notifications, password resets, etc.), refer to the [Sending Emails](doc:email) section.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Setup\"\n}\n[/block]\nYou'll need to configure your [MailChimp API key](http://kb.mailchimp.com/accounts/management/about-api-keys#Find-or-Generate-Your-API-Key) and [list ID](http://kb.mailchimp.com/lists/managing-subscribers/find-your-list-id) in the Settings page.\n[block:embed]\n{\n  \"html\": \"<iframe class=\\\"embedly-embed\\\" src=\\\"//cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2F_x8h3k5ffdw%3Ffeature%3Doembed&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D_x8h3k5ffdw&image=https%3A%2F%2Fi.ytimg.com%2Fvi%2F_x8h3k5ffdw%2Fhqdefault.jpg&key=02466f963b9b4bb8845a05b53d3235d7&type=text%2Fhtml&schema=youtube\\\" width=\\\"640\\\" height=\\\"480\\\" scrolling=\\\"no\\\" frameborder=\\\"0\\\" allowfullscreen></iframe>\",\n  \"url\": \"https://www.youtube.com/watch?v=_x8h3k5ffdw\",\n  \"title\": \"Setting up your newsletter\",\n  \"favicon\": \"https://s.ytimg.com/yts/img/favicon-vflz7uhzw.ico\",\n  \"image\": \"https://i.ytimg.com/vi/_x8h3k5ffdw/hqdefault.jpg\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Scheduling\"\n}\n[/block]\nWhen setting the “Newsletter Time” option, the time displayed is **in your server's timezone**, which may or may not be the same as your browser's current timezone. \n\nYou can double-check which date the server is using by previewing your campaign at `/email/campaign`. \n\nOne hour before the campaign is set to go out, you should receive a confirmation email. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Troubleshooting\"\n}\n[/block]\nYou can test that everything is working properly by:\n\n- Going to [/email/campaign](http://localhost:3000/email/campaign) to preview the newsletter and find out when it's scheduled to go out. \n- Running `Meteor.call('testCampaign')` from the browser console to schedule a test campaign (note that this will only work when on your app's main pages, not on the preview routes). \n\nCalling `testCampaign` will not mark your posts as sent inside Telescope, so the regular newsletter will still go out. \n\nIf your campaign fails to be scheduled, be sure to check your **server logs** (the client logs won't show any useful information) while you're calling `testCampaign` to see if any error occurred. Common errors include:\n\n- Missing or bad API keys and List IDs.\n- Your \"from\" email address's domain not being verified with MailChimp.","updates":["583c5353946fe32300633cff"],"order":10,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5635b292d209b50d0031dfcc","version":{"version":"0.25","version_clean":"0.25.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5635b291d209b50d0031dfc5","5635b291d209b50d0031dfc6","5635b291d209b50d0031dfc7","5635b291d209b50d0031dfc8","5635b291d209b50d0031dfc9","5635b291d209b50d0031dfca"],"_id":"5635b290d209b50d0031dfc4","__v":1,"createdAt":"2015-11-01T06:34:56.868Z","project":"550a7754635c660d0052808e","releaseDate":"2015-11-01T06:34:56.868Z"},"__v":1,"createdAt":"2015-07-10T00:53:12.291Z","project":"550a7754635c660d0052808e","category":{"sync":{"isSync":false,"url":""},"pages":["5635b292d209b50d0031dfcb","5635b292d209b50d0031dfcc","5635b292d209b50d0031dfcd","5635b292d209b50d0031dfce","5635b292d209b50d0031dfcf","5635b292d209b50d0031dfd0"],"title":"Using Telescope","slug":"using-telescope","order":1,"from_sync":false,"reference":false,"_id":"5635b291d209b50d0031dfc6","version":"5635b290d209b50d0031dfc4","project":"550a7754635c660d0052808e","__v":1,"createdAt":"2015-06-11T00:04:28.030Z"},"user":"5469e5dfa3b67a0e00559b06","githubsync":""}

Sending Newsletters


Telescope comes with a built-in email newsletter package that sends a daily or weekly newsletter through [MailChimp](http://mailchimp.com). Note that this section refers specifically to sending this automated newsletter. For in-app emails (such as notifications, password resets, etc.), refer to the [Sending Emails](doc:email) section. [block:api-header] { "type": "basic", "title": "Setup" } [/block] You'll need to configure your [MailChimp API key](http://kb.mailchimp.com/accounts/management/about-api-keys#Find-or-Generate-Your-API-Key) and [list ID](http://kb.mailchimp.com/lists/managing-subscribers/find-your-list-id) in the Settings page. [block:embed] { "html": "<iframe class=\"embedly-embed\" src=\"//cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2F_x8h3k5ffdw%3Ffeature%3Doembed&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D_x8h3k5ffdw&image=https%3A%2F%2Fi.ytimg.com%2Fvi%2F_x8h3k5ffdw%2Fhqdefault.jpg&key=02466f963b9b4bb8845a05b53d3235d7&type=text%2Fhtml&schema=youtube\" width=\"640\" height=\"480\" scrolling=\"no\" frameborder=\"0\" allowfullscreen></iframe>", "url": "https://www.youtube.com/watch?v=_x8h3k5ffdw", "title": "Setting up your newsletter", "favicon": "https://s.ytimg.com/yts/img/favicon-vflz7uhzw.ico", "image": "https://i.ytimg.com/vi/_x8h3k5ffdw/hqdefault.jpg" } [/block] [block:api-header] { "type": "basic", "title": "Scheduling" } [/block] When setting the “Newsletter Time” option, the time displayed is **in your server's timezone**, which may or may not be the same as your browser's current timezone. You can double-check which date the server is using by previewing your campaign at `/email/campaign`. One hour before the campaign is set to go out, you should receive a confirmation email. [block:api-header] { "type": "basic", "title": "Troubleshooting" } [/block] You can test that everything is working properly by: - Going to [/email/campaign](http://localhost:3000/email/campaign) to preview the newsletter and find out when it's scheduled to go out. - Running `Meteor.call('testCampaign')` from the browser console to schedule a test campaign (note that this will only work when on your app's main pages, not on the preview routes). Calling `testCampaign` will not mark your posts as sent inside Telescope, so the regular newsletter will still go out. If your campaign fails to be scheduled, be sure to check your **server logs** (the client logs won't show any useful information) while you're calling `testCampaign` to see if any error occurred. Common errors include: - Missing or bad API keys and List IDs. - Your "from" email address's domain not being verified with MailChimp.