This integration does the following things:
- Disable default Chec emails (on
integrations.readyevent, first run only) - Create transactional email templates in SendGrid, unless a template ID was provided for each email type
- Assemble data for transactional emails and send them using the SendGrid API
This repository runs in combination with the integration-helper. That repository provides context (e.g. merchant, API connectivity, integration info) and then runs the code in this repository.
When you make changes to this repository you will need to rebuild the dist files. For this, we use
@vercel/ncc:
npm run build
- Customers: new order. Sent when a new order is placed, this is the order receipt the customer receives.
- Customers: item shipped
- Customers: login token
| Event | Action | Template |
|---|---|---|
integrations.ready |
Initial setup | - |
orders.create |
Send customer receipt | "Order receipt" |
orders.receipt.resend |
Send customer receipt (again) | "Order receipt" |
orders.physical.shipment |
Send customer shipment notification | "Item shipped" |
customers.login.token |
Send customer login token | "Customer login token" |
When the integration first runs, it will run an initial setup phase. This is triggered by the event being "integrations.ready", which only runs for an integration at the time it is ready to be consumed. We can assume the integration has been provisioned at this point and DNS will be available.
The initial setup process does the following:
- Disable default Chec emails for each of the templates covered in this integration
- For email template, create a transactional template in SendGrid using default markup and dummy data, unless a template ID for each template was provided in the integration's config
- Once templates are created in SendGrid, update the integration's config in the Chec API with the new template IDs
See the templates directory, and the corresponding webhook event name (e.g. orders.create) for an HTML template
and JSON test data dump for each transactional template. These can be updated at any time, just make sure you've
tested them in the SendGrid Design Library first. Updating these files will not affect any existing integrations
that have been installed, only new ones.
During a standard run of this integration, the following will happen:
- Identify the email template ID for the corresponding event type (see table above)
- Assemble the data to power the template (take the webhook payload and add the merchant information to it)
- Send the email using SendGrid's API
See license.