Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Antavo Destination documentation #7276

Merged
merged 6 commits into from
Dec 19, 2024

Conversation

bbantavo
Copy link
Contributor

Proposed changes
Added Antavo Destination documentation files.

Merge timing
asap

Related issues (optional)

@bbantavo bbantavo requested a review from a team as a code owner November 29, 2024 15:21
@bbantavo bbantavo requested a review from stayseesong November 29, 2024 15:21
@seg-atlantis-prod
Copy link

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

@seg-atlantis-prod
Copy link

Error parsing command: EOF found when expecting closing quote

@seg-atlantis-prod
Copy link

Atlantis commands can't be run on fork pull requests. To enable, set --allow-fork-prs or, to disable this message, set --silence-fork-pr-errors

@seg-atlantis-prod
Copy link

Error parsing command: EOF found when expecting closing quote

@stayseesong stayseesong requested a review from tcgilbert December 2, 2024 21:32
@stayseesong stayseesong added the new-integration Added a new source or destination label Dec 2, 2024
Comment on lines 1 to 29
```
title: Antavo Actions Destination
```

Antavo Actions Destination app allows you to sync profile updates in Segment and trigger loyalty events.

This destination app is maintained by Antavo. For any issues with the destination app, [contact the Antavo support team](mailto:[email protected]).

## Getting started

1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank"} search for "Antavo Actions".
2. Select and click **Add Destination**.
3. Select an existing Source to connect to Antavo Actions.
4. Log in to Antavo and go to the **Settings → API Settings** menu; find and copy your Antavo **API key**.
5. Paste the **API Key** in the destination settings in Segment.
6. Go to mappings to set events you want to sync into Antavo
- Select the Profile event template to sync customer data changes into Antavo
- in this template, you need to map the customer ID first, which should match with the Antavo settings
- if the multi-account extension is enabled in Antavo, you need to make sure to include the account ID
- customer attributes be included in the Data section - make sure attribute names match your Antavo settings

![Enable Twilio Segment extension](images/1-antavo-select_type.png)
- Select the Loyalty event template to trigger loyalty events.
- in this template, you need to map the customer ID first, which should match with the Antavo settings
- if the multi-account extension is enabled in Antavo, you need to make sure to include the account ID
- event attributes can be included in the Data section - make sure attribute names match your Antavo settings

![Enable Twilio Segment extension](images/2-antavo-map_fields.png)
7. If you haven’t configured the Segment integration in Antavo, please go to the Modules menu and enable Twilio Segment Extension
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
```
title: Antavo Actions Destination
```
Antavo Actions Destination app allows you to sync profile updates in Segment and trigger loyalty events.
This destination app is maintained by Antavo. For any issues with the destination app, [contact the Antavo support team](mailto:[email protected]).
## Getting started
1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank"} search for "Antavo Actions".
2. Select and click **Add Destination**.
3. Select an existing Source to connect to Antavo Actions.
4. Log in to Antavo and go to the **Settings → API Settings** menu; find and copy your Antavo **API key**.
5. Paste the **API Key** in the destination settings in Segment.
6. Go to mappings to set events you want to sync into Antavo
- Select the Profile event template to sync customer data changes into Antavo
- in this template, you need to map the customer ID first, which should match with the Antavo settings
- if the multi-account extension is enabled in Antavo, you need to make sure to include the account ID
- customer attributes be included in the Data section - make sure attribute names match your Antavo settings
![Enable Twilio Segment extension](images/1-antavo-select_type.png)
- Select the Loyalty event template to trigger loyalty events.
- in this template, you need to map the customer ID first, which should match with the Antavo settings
- if the multi-account extension is enabled in Antavo, you need to make sure to include the account ID
- event attributes can be included in the Data section - make sure attribute names match your Antavo settings
![Enable Twilio Segment extension](images/2-antavo-map_fields.png)
7. If you haven’t configured the Segment integration in Antavo, please go to the Modules menu and enable Twilio Segment Extension
---
title: Antavo (Actions) Destination
---
The Antavo (Actions) Destination allows you to sync profile updates in Segment and trigger loyalty events.
This destination is maintained by Antavo. For any issues with the destination, [contact the Antavo support team](mailto:[email protected]).
## Getting started
1. From your workspace's [Destination catalog page](https://app.segment.com/goto-my-workspace/destinations/catalog){:target="_blank"} search for **Antavo (Actions)**.
2. Click **Add Destination**.
3. Select an existing Source to connect to Antavo (Actions).
4. Log in to Antavo and go to the **Settings > API Settings** and copy your Antavo **API key**.
5. Paste the **API Key** in the destination settings in Segment.
6. Configure your mappings to set events you want to sync to Antavo. You can choose from 2 actions: Send Loyalty Event and Send Profile Update.
- If the multi-account extension is enabled in Antavo, make sure to include the account ID.
- If customer attributes are included in the Data section - make sure attribute names match your Antavo settings.
7. If you haven’t configured the Segment integration in Antavo, go to the **Modules** menu and enable the Twilio Segment Extension in Antavo.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hi @stayseesong

thanks for the suggestions, we have applied them, please check them

@tcgilbert
Copy link
Contributor

@bbantavo @stayseesong - we can merge this as hidden once my requested changes are in. The destination is still pending review, so there is no destination id for this yet

@stayseesong
Copy link
Contributor

@tcgilbert I don't see your requested changes

@stayseesong stayseesong self-requested a review December 13, 2024 23:11
Comment on lines 1 to 3
---
title: Antavo (Actions) Destination
---
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
---
title: Antavo (Actions) Destination
---
---
title: Antavo (Actions) Destination
hidden: true
---

6. Configure your mappings to set events you want to sync to Antavo. You can choose from 2 actions: Send Loyalty Event and Send Profile Update.
- If the multi-account extension is enabled in Antavo, make sure to include the account ID.
- If customer attributes are included in the Data section - make sure attribute names match your Antavo settings.
7. If you haven’t configured the Segment integration in Antavo, go to the **Modules** menu and enable the Twilio Segment Extension in Antavo.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
7. If you haven’t configured the Segment integration in Antavo, go to the **Modules** menu and enable the Twilio Segment Extension in Antavo.
7. If you haven’t configured the Segment integration in Antavo, go to the **Modules** menu and enable the Twilio Segment Extension in Antavo.
{% include components/actions-fields.html %}

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hi @tcgilbert

we've applied the changes, please check

@tcgilbert
Copy link
Contributor

@tcgilbert I don't see your requested changes

@stayseesong sorry was left in pending! added my review now @bbantavo

@stayseesong
Copy link
Contributor

@tcgilbert is this good to merge in even though there's no destination ID?

@stayseesong stayseesong merged commit 75f1084 into segmentio:develop Dec 19, 2024
4 checks passed
Copy link
Contributor

Thank you for your contribution! Your pull request is merged, but may take a day or two to appear on the site.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
new-integration Added a new source or destination
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants