Connecting Slack
Edit in CMSConnect Slack and your team sees when a newsletter is scheduled or sent, without anyone logging in to Letterhead to check.
What you’ll get in Slack
Section titled “What you’ll get in Slack”Letterhead posts a message to the Slack channel you choose when:
- A newsletter is scheduled. As soon as someone on your team schedules one, a message lands in Slack with a View Newsletter button that opens it in Letterhead. Drafts that are only saved don’t post.
- A newsletter goes out. When it moves on from being scheduled, Letterhead posts a follow-up, marked Sending while it’s going out and Published once it’s out. This follows the send itself, not the newsletter’s metrics.
Both messages include the newsletter’s title, which channel it belongs to, its publication date and time zone, the audience or segment it went to, and a link to view it in Letterhead. The View Newsletter button needs the newsletter to have a web address, which it gets once it has been previewed, so a newsletter scheduled before it was ever previewed may arrive without the button.
Other events, such as promotion updates and audience changes, don’t post to Slack.
Before you start
Section titled “Before you start”- A company administrator connects Slack, from the company’s settings. The Slack card doesn’t appear for other roles. Once it’s connected, every newsletter in every group in your company posts to the same Slack channel; there’s no per-group or per-newsletter setting.
- You need permission to add an app to your Slack workspace. Many workspaces limit app installs to Slack admins or ask for an admin’s approval. If that’s you, ask your Slack admin to install the Letterhead app or approve your request.
- Your browser must allow pop-ups from
app.tryletterhead.com, because Slack’s sign-in opens in a new window.
Connect Slack
Section titled “Connect Slack”- In your company workspace, go to Settings → Integrations and find the Slack card (“Connect your Slack workspace to receive notifications”).
- Click Connect to Slack. Slack’s sign-in opens in a new window.
- Sign in if you need to, and choose the Slack workspace your team uses.
- Choose the Slack channel Letterhead should post to. Every message goes to this one channel, so a dedicated newsletter operations channel usually works better than a general one.
- Click Allow. You’re taken back to Letterhead, and the card shows Connected to your workspace name.
To check it, schedule a test newsletter (or wait for the next real one) and look for the message in the channel you picked. It arrives within a few seconds.
Disconnect Slack
Section titled “Disconnect Slack”In Settings → Integrations, open the Slack card and click Disconnect. Messages stop straight away.
Disconnecting also revokes Letterhead’s access to your Slack workspace, so Letterhead can’t post there again until you reconnect. The Letterhead app may still appear in your workspace’s list of installed apps; your Slack admin can remove it there if you’d like it gone.
If someone removes the Letterhead app on the Slack side without disconnecting in Letterhead, Letterhead can no longer deliver messages and emails your team’s administrator to say so. Reconnect from Settings → Integrations to start the messages again.
When to contact us
Section titled “When to contact us”If Letterhead says it couldn’t start or finish the Slack connection, try again in a minute; that usually means Slack’s sign-in service didn’t answer. If it keeps happening, or the Slack card is missing even though you’re a company administrator in your company settings, contact support and we’ll sort it out. Want Slack to cover more events? Tell us.
Still can’t find what you need? Contact support.