# Delighted Source

## Source Info

* The Delighted Source is an **Event Cloud** source. This means that it sends data as events, which are behaviors or occurrences tied to a user and a point in time. Data from these sources can be loaded into your Segment warehouses, and **also** sent to Segment streaming destinations. [Learn more about cloud sources.](/docs/segment/connections/sources#cloud-app-sources)

> \[!WARNING]
>
> This Source is only supported in workspaces configured to process data in the US region. Workspaces configured with data processing regions outside of the US cannot connect to this source. For more information, see [Regional Segment](/docs/segment/guides/regional-segment/).

[Delighted](https://delighted.com/) lets you gather actionable feedback from your customers. Use the feedback you gather from customers in all of your decision making processes. Send your feedback to your BI and data warehouses automatically.

This source is maintained by Delighted. For any issues with the source, [contact the Delighted Support team](mailto:hello@delighted.com).

## Getting started

1. From your Segment UI's Sources page, click on **Add Source**.
2. Search for Delighted within the Sources Catalog and confirm by clicking **Connect**.
3. Give the Source a nickname and follow the set up steps to add your source. The nickname is used as a label for the source in your Segment interface, and Segment creates a related schema name which you query against in your warehouse. The nickname can be anything, but we recommend sticking to something that reflects the source itself and distinguishes amongst your environments (for example, Delighted\_Prod, Delighted\_Staging, Delighted\_Dev).
4. Sign in to your Delighted account and visit the [Segment destination](https://delighted.com/integrations/segment) to connect.
5. Once you connect with Segment you need to choose which Track events you'd like to use as triggers for surveys to be sent people. Then you can configure Delighted to send feedback back to Segment.
6. Enable the **Sync feedback to Segment** option.
7. Copy the Write Key from your Delighted source within Segment and paste it into the provided box within Delighted

**Note**: We only send feedback back to Segment on surveys triggered from Segment initially. This ensures all feedback we send to Segment is identified and enriched with Segment information.

## Components

Delighted uses our stream Source component to send events to Segment. These events are then available in any Destination that accepts server-side events, including your data warehouse.

## Events

The following table lists events that Delighted sends to Segment. These events will show up as tables in your warehouse, and as regular events in your other Destinations.

Delighted always sends the values received from Segment for the `user_id` and/or `anonymous_id` identifiers. All calls sent to Segment from Delighted will include the original value, Delighted never generates these.

Additionally, they also send `email` and `delighted_person_id` under `context.traits`.

| Event name               | Description                                           |
| ------------------------ | ----------------------------------------------------- |
| Survey Question Answered | A user answered a question on a survey they received. |

## Event properties

The following table outlines the properties included in the events.

| Property name          | Description                                                                                                                      |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `survey_id`            | The Delighted identifier for the survey.                                                                                         |
| `survey_name`          | The name of the survey.                                                                                                          |
| `survey_type`          | The type of the survey. For example, "NPS" or "CES".                                                                             |
| `survey_medium`        | The medium used for the survey. For example, "Email" or "SMS".                                                                   |
| `survey_tool`          | The name of the survey tool. This will always be "Delighted".                                                                    |
| `survey_question_id`   | The Delighted identifier for the question.                                                                                       |
| `survey_question_name` | The name of the question.                                                                                                        |
| `survey_question_text` | The exact text shown to the user for this question.                                                                              |
| `survey_permalink`     | A permanent URL to view the survey response on Delighted.                                                                        |
| `survey_tags`          | An array of tags added to the survey response in Delighted.                                                                      |
| `survey_notes`         | An array of notes added to the survey response in Delighted.                                                                     |
| `survey_properties`    | An object containing optional data attached to the survey. This will include all properties sent in the triggering "track" call. |

## Adding destinations

Now that your source is set up, you can connect it to destinations.

Log in to your downstream tools and check to see that your events are populating and they contains all the properties you expect. If all your events and properties are not showing up, refer to the relevant [destination docs](/docs/segment/connections/destinations/) for troubleshooting.

If you experience any issues with how the events arrive in Segment, [contact the Delighted team](mailto:hello@delighted.com).

## Sending data To Delighted

The Delighted Source works only when you also connect Delighted as a downstream destination within Segment. With the Delighted destination, you can send Delighted user and event data, which you can use to trigger surveys. For more information, see the [Delighted destination docs](/docs/segment/connections/destinations/catalog/delighted/).