Set up guide to send Email notifications via SuprSend.
Create SuprSend account
Simply signup on SuprSend to create your account. If you already have your company account setup, ask your admin to invite you to the team.
Start testing in Sandbox workspace
You’ll see 3 workspaces in your SuprSend account: Sandbox, Staging and Production. Workspaces can be switched from top navigation bar.
Create a workflow
Workflow houses the automation logic of your notification. Each workflow starts with a trigger, processes the defined logic, and sends one or more messages to the end user. You can create a workflow from SuprSend dashboard by clicking on button on the workflows tab.
To design a workflow, you need:
A Trigger point- Trigger initiates the workflow. You can initiate it
Delivery node- Delivery Nodes represent the channels where users will receive notifications. You can use:
multi-channel nodes, to send messages across multiple channels,
smart channel routing, to notify users sequentially rather than bombarding them on all channels at once (though it’s generally better to use).
Template in delivery node contains the content of the notification. You can add both static and dynamic content sourced from user properties or trigger payloads. We use handlebars as our Whatsapp templating language. You can add dynamic content as {{var}}
.
Add trigger data in the mock to get variable auto-suggestions during editing. Ensure to publish the template before using it in a workflow.
Trigger the workflow
You can trigger a test workflow directly from dashboard by clicking on ” button in your workflow editor or “Commit” changes to trigger it from your code. We follow Git like versioning for workflow changes, so you need to commit your changes to trigger new workflow via the API. You can check all methods of triggering workflow here.
To trigger a workflow, you need:
distinct_id
within SuprSend and must have the relevant channel identity set in their profile. You can define recipient inline in case of API based trigger or create user profile first for event based trigger.
In Sandbox environment, a sample user with your registered email ID is pre-created for testing. You can always add more users or edit existing user profile from subscriber page on UI.We’ll be triggering the workflow with direct API trigger for quick testing. You can check all trigger methods here.
You can get workspace key, secret or API Key for trigger from Settings tab -> API Keys
Check logs to see the status of your sent notification
Once triggered, you can monitor the request and it’s status on the “Requests” tab, and view step-by-step debugging of each execution on the Execution
tab inside workflow.
Test with your Email vendor
You have to bring your own vendor to setup email notification in staging and production workspaces. However, you can test your workflows in Sandbox where sample vendors are pre-added. You can clone workflows from one workspace to another. All you have to do is fill in the vendor form for your respective vendor and you are good to go.
Push to Production
In SuprSend, each environment is isolated, meaning workflows, users, and vendors are configured separately in testing and production workspaces.
Follow this go live checklist to setup things in production once you are done testing.