{"_id":"5635b292d209b50d0031dfcc","version":{"_id":"5635b290d209b50d0031dfc4","__v":1,"project":"550a7754635c660d0052808e","createdAt":"2015-11-01T06:34:56.868Z","releaseDate":"2015-11-01T06:34:56.868Z","categories":["5635b291d209b50d0031dfc5","5635b291d209b50d0031dfc6","5635b291d209b50d0031dfc7","5635b291d209b50d0031dfc8","5635b291d209b50d0031dfc9","5635b291d209b50d0031dfca"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"0.25.0","version":"0.25"},"__v":1,"project":"550a7754635c660d0052808e","category":{"_id":"5635b291d209b50d0031dfc6","version":"5635b290d209b50d0031dfc4","pages":["5635b292d209b50d0031dfcb","5635b292d209b50d0031dfcc","5635b292d209b50d0031dfcd","5635b292d209b50d0031dfce","5635b292d209b50d0031dfcf","5635b292d209b50d0031dfd0"],"project":"550a7754635c660d0052808e","__v":1,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-06-11T00:04:28.030Z","from_sync":false,"order":1,"slug":"using-telescope","title":"Using Telescope"},"user":"5469e5dfa3b67a0e00559b06","githubsync":"","updates":["583c5353946fe32300633cff"],"next":{"pages":[],"description":""},"createdAt":"2015-07-10T00:53:12.291Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":10,"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.","excerpt":"","slug":"sending-newsletters","type":"basic","title":"Sending Newsletters"}

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.