Marketing, Forms and Social
Marketing, Forms and Social are three areas of Hearth for the work that reaches people outside your company. Each one reads and writes the records of an app you already run, through that app's own interface, so what a person changes in Hearth is what the app holds, and what the app holds is what Hearth shows.
All three are in the left rail for everyone who is signed in. An area whose app is not connected says so on its page and names the settings to make, so an empty page never has to be guessed at. Contractors do not see them unless an administrator lists the page for them.
Marketing
Emails, campaigns, and segments.
- Emails. List and search them, create and edit one, give it a time to go live, publish or unpublish it, send it to its segments now, and delete it.
- Campaigns. List them with the number of people in each, create one that sends an email a set number of days after someone joins, edit its dates, publish or unpublish it, and delete it.
- Segments. List them with how many people are in each, create, edit, and delete.
| Setting | Meaning |
|---|---|
HEARTH_MARKETING_URL | The address of your email marketing app, one Hearth can reach |
HEARTH_MARKETING_CLIENT_ID, HEARTH_MARKETING_CLIENT_SECRET | An API client that may read and write emails, campaigns, and segments |
Forms
Forms and their answers.
- List your forms with their state: draft, scheduled, live, paused, or closed.
- Create and edit a form from a plain list of questions, one to a line. Start a line with
[text],[choice],[multi],[rating], or[nps], add the choices after::separated by;, and end a line with*to make the question required. For example,[choice] How did you hear about us? * :: A friend; Search; An event. - Publish now, pause, close, or return a form to draft. Choose the day a form goes live and the day it closes. A form goes live at the start of the day you choose.
- Read the answers in a table with a column for each question, and delete a form together with its answers.
| Setting | Meaning |
|---|---|
HEARTH_FORMS_URL | The address of your forms app |
HEARTH_FORMS_API_KEY | An API key with read and write access to the forms |
Social
Channels, posts, and their numbers.
- See the connected channels, and each one's numbers for the last thirty days.
- Write a post for one or more channels and publish it now, schedule it, or keep it as a draft.
- See the posts of the last month and the next three with their state, and delete any of them.
You connect a channel in your social publishing app, where each network asks for its own sign-in. Until one is connected, the page says so. Your social app limits how often it can be asked, so Hearth keeps the channel list and posts for a short while, and says so when the limit is reached.
| Setting | Meaning |
|---|---|
HEARTH_SOCIAL_URL | The address of your social publishing app |
HEARTH_SOCIAL_API_KEY | Its API key |
With the Helm chart these are the marketing, forms, and social values, each with the Secret that holds its credential.
Tools
The Tools entry in the rail is a launcher: one card for each app your company opens often, each linking to the live service and opening in a new tab. Set HEARTH_TOOLS to a JSON list, or the tools value in the chart:
tools:
- name: Ops
description: Orders, invoices, and stock.
href: https://ops.example.com
- name: Vord
description: Your account and sign-in.
href: https://vord.example.com
note: Signs in with Vord.
A card needs a name and an http or https address, and Hearth refuses to start with a mistake in the list rather than show a dead card. With no list, Tools is not in the rail.