From 61c6f42dea79957433267be94b0830cf9cf66043 Mon Sep 17 00:00:00 2001 From: pwseg Date: Thu, 10 Aug 2023 16:26:41 -0600 Subject: [PATCH 1/3] Add Astrolabe Docs --- .../destinations/catalog/astrolabe/index.md | 75 +++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 src/connections/destinations/catalog/astrolabe/index.md diff --git a/src/connections/destinations/catalog/astrolabe/index.md b/src/connections/destinations/catalog/astrolabe/index.md new file mode 100644 index 0000000000..8f3dcde29b --- /dev/null +++ b/src/connections/destinations/catalog/astrolabe/index.md @@ -0,0 +1,75 @@ +--- +title: Astrolabe Destination +id: 64d2643196f4937712e54198 +--- + +[Astrolabe](https://astrolabe.so/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners){:target="_blank"} is a Revenue Operations Platform built for go-to-market teams to generate pipelines, prioritize, close, and grow accounts. It's a no-code AI-based platform that empowers teams to easily access data, build advanced predictive machine learning models, create efficient workflows, and drive better results without technical expertise. + +This destination is maintained by Astrolabe. For any issues with the destination, [contact the Astrolabe Support team](mailto:team@astrolabe.so). + +## Getting Started + +### Obtain your Astrolabe API Key + +1. Login to your [Astrolabe workspace](https://console.astrolabe.so/login){:target="_blank"}. +2. Navigate to the [Connectors page](https://console.astrolabe.so/connectors){:target="_blank"} and click **Add Connector**. +3. Choose the **Segment.com Connector**. +4. Name the Connector and click **Continue**. +5. Decide whether to allow or block users with free email providers, then click **Finish**. +6. Copy the **API key** displayed in the dialog window. + +### Add Astrolabe Destination to your Segment Workspace + +1. In the Segment web app, go to **Connections > Catalog** and then click on the **Destinations** tab. +2. Search for **Astrolabe** and select it. +3. Click **Add destination**. +4. Choose an existing data Source to connect to **Astrolabe**. +5. Give the destination a name that is recognizable. +6. Paste the **Astrolabe API key** (copied earlier). +7. Enable the destination by changing the bottom **Enable Destination** toggle to active. +8. Click **Save Changes**. + +## Supported methods + +Astrolabe supports the following methods, as specified in the [Segment Spec](/docs/connections/spec). + +### Identify + +If you aren't familiar with the Segment Spec, take a look at the [Identify method documentation](/docs/connections/spec/identify/) to learn about what it does. An example call would look like: + +```js +analytics.identify("userId123", { + email: "john.doe@example.com", +}); +``` + +Segment sends Identify calls to Astrolabe as an `identify` event. When you identify a new user, Astrolabe creates a new User record. If the User already exists, Astrolabe updates the User's properties. + +### Group + +If you aren't familiar with the Segment Spec, take a look at the [Group method documentation](/docs/connections/spec/group/) to learn about what it does. An example call would look like: + +```js +analytics.group("0e8c78ea9d97a7b8185e8632", { + name: "Initech", + industry: "Technology", + employees: 329, + plan: "enterprise", + "total billed": 830, +}); +``` + +Segment sends Group calls to Astrolabe as an `group` event. A `group` event can create an Account, If the Account already exists, Astrolabe updates the Account's properties. A `group` event can also associate a User to an Account within Astrolabe. + +### Track + +If you aren't familiar with the Segment Spec, take a look at the [Track method documentation](/docs/connections/spec/track/) to learn about what it does. An example call would look like: + +```js +analytics.track("User Registered", { + plan: "Pro Annual", + accountType: "Facebook", +}); +``` + +Segment sends Track calls to Astrolabe as a `track` event. \ No newline at end of file From 8f2e53b5f7db4cb24cbfb1282f23ebdbeaf30da0 Mon Sep 17 00:00:00 2001 From: Thomas Gilbert <64277654+tcgilbert@users.noreply.github.com> Date: Fri, 11 Aug 2023 09:19:28 -0400 Subject: [PATCH 2/3] Update src/connections/destinations/catalog/astrolabe/index.md Co-authored-by: stayseesong <83784848+stayseesong@users.noreply.github.com> --- src/connections/destinations/catalog/astrolabe/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/connections/destinations/catalog/astrolabe/index.md b/src/connections/destinations/catalog/astrolabe/index.md index 8f3dcde29b..a10e9f71d1 100644 --- a/src/connections/destinations/catalog/astrolabe/index.md +++ b/src/connections/destinations/catalog/astrolabe/index.md @@ -11,7 +11,7 @@ This destination is maintained by Astrolabe. For any issues with the destination ### Obtain your Astrolabe API Key -1. Login to your [Astrolabe workspace](https://console.astrolabe.so/login){:target="_blank"}. +1. Log in to your [Astrolabe workspace](https://console.astrolabe.so/login){:target="_blank"}. 2. Navigate to the [Connectors page](https://console.astrolabe.so/connectors){:target="_blank"} and click **Add Connector**. 3. Choose the **Segment.com Connector**. 4. Name the Connector and click **Continue**. From 2eab13b0b08dc9ce4ca8e41a937b737f8a694676 Mon Sep 17 00:00:00 2001 From: pwseg <86626706+pwseg@users.noreply.github.com> Date: Fri, 11 Aug 2023 10:32:44 -0600 Subject: [PATCH 3/3] Update src/connections/destinations/catalog/astrolabe/index.md Co-authored-by: stayseesong <83784848+stayseesong@users.noreply.github.com> --- src/connections/destinations/catalog/astrolabe/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/connections/destinations/catalog/astrolabe/index.md b/src/connections/destinations/catalog/astrolabe/index.md index a10e9f71d1..26cae4ee43 100644 --- a/src/connections/destinations/catalog/astrolabe/index.md +++ b/src/connections/destinations/catalog/astrolabe/index.md @@ -7,7 +7,7 @@ id: 64d2643196f4937712e54198 This destination is maintained by Astrolabe. For any issues with the destination, [contact the Astrolabe Support team](mailto:team@astrolabe.so). -## Getting Started +## Getting started ### Obtain your Astrolabe API Key