Postways is a message system where you have to bring your own means of transport. This means that to be able to send e.g. emails, you need to have added an Integration to Postways that supports the sending of email. Within the Postways eco-system often refer to this as "transport".
Postways currently supports the follow integrations:
- Amazon Web Services (AWS)
- Email / SMTP
- HTTP Callback
In the following sections we're going to look at each of them.
Amazon Web Services (AWS)
The easiest integration to use is the AWS Platform Integration. This integration will allow you to send email, SMS and mobile push notifications all through one convenient set up.
To add the AWS integration go to your Team, select Settings, select Integrations and click the Add Integration button. From the first drop-down select Platform and from the second drop-down select AWS (default). You are now presented with 3 fields:
- External ID
- Role ARN
- AWS Region
The External ID will be provided to you and it is the token that you need to set up an AWS AIM Role. For a reference on how to connect Postways to your AWS account, please refer to the Amazon AWS section in the Developer Guide where a complete walk through will guide you through the various AWS specific steps.
Once the AWS AIM Role is created, it will give you access to an ARN. This ARN must be copied and pasted into the Role ARN field of the Integration.
Last but not least, select the AWS Region from which you are going to send email, SMS and/or mobile push notifications. This is important because AWS SES and SNS are region specific and not selecting the correct AWS Region will result in errors.
Email / SMTP
If you do not have an AWS account, or, if you only want to send email through Postways then it's possible to simply use the SMTP integration. Many existing services support SMTP such as; Postmark App, Mailgun, Sendgrid, etc. AWS also provides an SMTP solution but if you are going to use AWS then it is recommended that you use the AWS Platform integration instead.
To add an SMTP integration go to your Team, select Settings, select Integrations and click the Add Integration button. From the first drop-down select Email and from the second drop-down select SMTP (default). You are now presented with 4 fields:
Each of the fields speak for themselves and are provided by your SMTP provider.
The HTTP Callback integration allows for Postways to call an HTTP endpoint. The HTTP Callback integration is suitable if you prefer not to share any sensitive information with Postways or if you need to post messages to third party targets, e.g. post a message into the Slack account of one of your customers.
To add the HTTP Callback integration go to your Team, select Settings, select Integrations and click the Add Integration button. From the first drop-down select Callback and from the second drop-down select HTTP (default). You are now presented with 1 field:
Simply paste your own HTTP endpoint URL into the URI field. Optionally you can add any HTTP header your endpoint requires. Please keep in mind that the
Content-type: application/json header will always be send.