RudderStack
Send Encatch survey events to RudderStack - where to find the details in RudderStack and how to set up the connection
Overview
The RudderStack connector sends survey events to a RudderStack source. RudderStack then passes them on to every destination connected to that source.
| What it gets | Survey events on a source, passed on to every destination connected to it |
| Events | Survey shown, started, submitted, partially submitted and dismissed |
| Anonymous respondents | Supported, with Include anonymous respondents on |
| User profile | Updated with the user's traits when Update the user's profile is on |
| Status | Available |
What You'll Need
Before you start, make sure you have:
- A RudderStack workspace — Cloud, or self-hosted with a public HTTPS data plane on port 443
- An HTTP source — made for Encatch (Step 1)
- The source's Write key and your Data plane URL
Step 1: Create a source and copy its details in RudderStack
- In RudderStack, open Sources and add a new source of type HTTP. Give it a name you'll recognise, for example
Encatch. - On the source's Setup tab, copy the Write key.
- Copy your Data plane URL. RudderStack shows it at the top of the Connections page. It looks like
https://yourcompany.dataplane.rudderstack.com.
Step 2: Add the connection in Encatch
- In Encatch, open Data sync → Survey events and click Add connection.
- Choose RudderStack.
- Enter a Name you'll recognise in the list and in Logs.
- Fill in the RudderStack settings:
| Field | What to enter |
|---|---|
| Data plane URL | Your data plane's address, starting with https://. Required. |
| Source write key | The Write key of the HTTP source. |
- Press Test connection. Encatch shows what RudderStack answered.
Encatch keeps the keys encrypted and never shows them again. To change one later, press Replace.
Step 3: Choose what to send
- Under Surveys, choose All surveys or Only these surveys.
- Under What is sent, tick the events to send. A new connection starts with Survey shown, started, submitted and dismissed ticked. Survey partially submitted is off until you tick it.
- Rename an event if you want another name in RudderStack. The defaults are
encatch_survey_shown,encatch_survey_started,encatch_survey_submitted,encatch_survey_partialandencatch_survey_dismissed. - To also send responses of people who are not signed in, turn on Include anonymous respondents.
- Open Advanced options to choose how users are identified, whether answers are sent and the rate limit.
Every option is explained in Connection settings.
Step 4: Save and start sending
Click Save. Saving does not start sending: press Start sending when you are ready. From then on events go out as they happen, and every delivery is listed in Logs.
Check it in RudderStack
Open the source's Live events in RudderStack. Test connection shows there as encatch_test_event. Survey events show as track calls under the names you chose and, with Update the user's profile on, an identify call carries the user's traits.
Good to know
- Anonymous respondents arrive with an anonymous ID and no user ID.
- Rate limit. A new connection starts at 500 events a minute: RudderStack's Free plan takes 1,000 events a minute. On a paid or self-hosted plan you can raise the limit or clear it.
- Self-hosted. The data plane must be reachable from the internet over HTTPS on port 443. Encatch never calls IP addresses, internal names or other ports.
Troubleshooting
| What you see | What it means | What to do |
|---|---|---|
| Enter Data plane URL as a full address | The address is missing https:// or is not a public host name | Paste the whole address from RudderStack |
| Key refused | The Write key belongs to another source or workspace | Copy it again from the source's Setup tab |
Was this page helpful?
