Setting up
Connecting Syndigo
What you need from Syndigo
- The Event Hub connection string: the address and key of the Event Hub they receive your records on. It starts with "Endpoint=sb://".
- The Event hub name, if the connection string doesn't already include it.
- The attribute names your Syndigo account takes. These are what you map your product fields onto.
The Connect form
- In the Integrations app, go to Connectors and open Syndigo.
- Paste the Event Hub connection string. It is stored as a secret: after saving, the form only shows that it is set. To keep it, leave the box blank next time.
- Fill in Event hub name only if the connection string has no hub name in it.
- Fill in the settings below.
- Choose Save.
| Setting | What it does |
|---|---|
| Syndigo attributes | The attribute names your Syndigo account takes, separated by commas. Write "name: Label" to give one a friendlier label. Only these are sent. |
| Record type | Optional. Stamped on every record as its type. |
| Default locale | The language each value is marked with. Starts as en-US. |
| Default value source | Where each value is marked as coming from. Starts as internal. |
| Record id attribute | A mapped attribute whose value becomes the Syndigo record id. Leave it empty to use the SmartLinks product id. |
| Record name attribute | A mapped attribute whose value becomes the record name. Leave it empty to use the product name. |
| Wrap each record in entities[] | On by default. Leave it on unless Syndigo asks you to turn it off. |
Test the connection
Under Test connection, choose Test. It checks the connection string against the Event Hub without sending anything. A good result says it connected to your event hub, or that the key is accepted for it.
Under Syndigo fields, choose Load to see the attributes you listed. These are what you'll map onto.
Set up the flow
- Under Flows, in Start from a preset, choose Products → Syndigo. It sends products when they're created or updated. New flows start as drafts.
- Choose Mapping on the flow. Match each SmartLinks product field to a Syndigo attribute, then choose Save mapping.
- Choose Send one, type a product's id and choose Send. This is a real delivery to Syndigo, even while the flow is a draft. Ask Syndigo to confirm it arrived as expected.
- Choose Activate. From now on, product changes are sent automatically.
You can also use Run now to send straight away, Pause to stop sending, and Runs to see each run and how many records went through or failed.