About
Echo's Wufoo Integration allows you to send messages to Echo and start conversations from Wufoo web forms. Wufoo forms start email conversations in Echo, so your form must have an Email field. A submission without an email address is rejected.
Create a Web Contact Website in Echo
Before you set up the form on your website and connect that to Echo, you will need to create or choose an Echo Web Contact Website. You can find the list of Web Contact Websites for your tenant in Admin > Email > Websites.
To Create a new website:
- +
Click "+ New Website" - Enter a Name, then choose the Referrer: an email source if your form collects an email address, or a text-message source if it collects a phone number.
- Make a note of the UUID for future use.
- Change the default replying email address if desired (email address user name).
- Click "Create Web Contact Website".
It can be helpful to make new Echo Web Contact Websites for each new web form on your site(s). Doing so will provide you with more granular reporting.
Note: You will need to provide the web contact website UUID to the Wufoo webhook. That will happen while following the steps in the Wufoo getting started docs. Echo’s website uuid will be used as the “Handshake Key”. This uuid/handshake key will be used to authenticate form fills and to let Echo how to process those form fills.
Wufoo Setup
Follow the guide here: https://help.wufoo.com/articles/en_US/kb/Wufoo-REST-API-V3 to hook a wufoo webhook to Echo. You will need the following data to complete this guide:
| Wufoo Field | Value |
|---|---|
WebHook URL | https://your-echo-url.echoglobal.org/api/webhooks/wufoo |
WebHook Handshake Key | The UUID saved from the previous section. |
Delete Table - Column + Column + Row - Row |
How Echo reads your Wufoo form
Echo does not read your form by the labels you chose. It reads each field by its Wufoo field type, by a CSS class you add to the field, or, for a few, by the field's title. You add a CSS class to a field in the Wufoo form builder.
| What Echo gets | How to set it up in Wufoo |
|---|---|
Email (required) | Add an Email field. Echo sends its replies to this address. A submission with no email is rejected. |
Name | Add a Name field, or a single line text field with the CSS class |
Gender | Give a field the title Gender (Echo also recognizes the word in several other languages), or give it the CSS class |
Age | Give a field the CSS class |
Phone | Add a Phone field. Echo saves the number on the seeker. A form cannot start a text conversation: every Wufoo conversation starts by email. |
Address | Add an Address field. Echo reads Street Address, Address Line 2, City, State / Province / Region, Postal / Zip Code and Country. |
Page URL | Give a field the CSS class |
Outreach and outreach code | Give fields the CSS classes |
Callback URL | Give a field the CSS class |
UTM values | Title a field |
IP address | Nothing to set up. Echo uses the IP address Wufoo records for the submission, for IP geolocation. |
The message | Every other field. Echo writes each one into the first message as the field's title with the seeker's answer beneath it. |
Topic | The first 100 characters of the message, unless the Web Contact Website has a Topic Field set to the title of one of your fields. |