Send query results to Amazon Pinpoint

You can send phone numbers and SMS message strings from Amperity to Amazon Pinpoint. First build a query that outputs phone numbers and a message. Then use an orchestration to send that data from Amperity to Amazon Pinpoint.

Note

A Lambda function running in AWS Lambda validates phone numbers, and then only sends validated phone numbers to Amazon Pinpoint.

Send phone numbers and SMS message strings from Amperity to Amazon Pinpoint.

This topic describes the steps that are required to send phone numbers and SMS message strings to Amazon Pinpoint from Amperity:

  1. Build a query

  2. Add orchestration

  3. Run orchestration

Note

Amazon Pinpoint must be enabled as a webhook destination before you can configure an orchestration to send query results. Work with your DataGrid Operator or Amperity representative to configure Amazon Pinpoint for your tenant.

Build query

Build a query that returns phone numbers and SMS message strings. For example:

SELECT
  phone as "phone_number"
  ,CONCAT('Hello ', given_name, '! Please enjoy 25% more content on your next visit to https://docs.amperity.com') AS "message"
FROM Merged_Customers

Note

A Lambda function running in AWS Lambda will phone numbers before sending data to Amazon Pinpoint.

Add orchestration

An orchestration defines the relationship between query results and a destination, including the location to which those query results will be sent and the frequency at which the orchestration will be run.

To add an orchestration

  1. From the Destinations tab, click Add Orchestration. This opens the Add Orchestration dialog box.

  2. From the Object Type drop-down, select Query.

  3. From the Object drop-down, select the query for which results will be sent to Amazon Pinpoint.

  4. From the Destination drop-down, select a destination that is configured for sending data to Amazon Pinpoint.

  5. From the Data Template drop-down, select a data template.

  6. Verify all settings.

  7. Set the workflow to Manual. (You can change this to automatic later, after verifying the end-to-end workflow.)

  8. Click Save.

Run orchestration

Run the orchestration manually to validate that it works.

To run the orchestration

  1. From the Destinations tab, under Orchestrations, open the    menu for the Amazon Pinpoint orchestration, and then select Run.

  2. The Status column for the orchestration will update to say “Waiting to start…”, after which the notifications pane will update to include a notification that shows the current status.

  3. When the orchestration has run successfully, the status is updated to “Completed”.