About
Echo's Wufoo Integration allows you to send messages to Echo and start conversations from Wufoo web forms. You can use this api to start new Email and SMS conversations in Echo.
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" - Choose an Email Domain to use for email responses.
- 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 |
Request parameters
Echo supports the following form field types:
| Field Name | Required | Description |
|---|---|---|
yes | The email address of the seeker. Echo will send outbound email messages to this email address | |
phone | yes (only for sms conversations) | The phone number of the seeker. Echo will send text messages to this phone number. Valid formats include: +19293685323, 929-368-5323, (929)368-5323, 9293685323, 929.368.5323, etc. |
to_phone | yes ( only for sms conversations) | Must be a valid Echo provisioned phone number. Must be formatted like so: +19293685323 Just copy/paste the number as shown in Echo's admin page linked above |
name | no | The name of the seeker |
gender | no | The gender of the seeker |
age | no | The age of the seeker (0-99+) |
ip_address | no | the ip address of the seeker. Use for ip geolocation lookup. |
ip | no | alternative to ip_address |
body | recommended | The words written by the seeker. Will be used to create a message body in Echo. |
topic | no | The topic or subject of the conversation. Field is ignored if there is already an active conversation in Echo with this seeker. |
outreach | no | A client metadata field. |
outreach_code | no | A client metadata field. |
utm_campaign | no | A utm field. |
utm_source | no | A utm field. |
utm_medium | no | A utm field. |
utm_content | no | A utm field. |
utm_outreach | no | A utm field. |
url | no | The url of the webpage the seeker was on when they submitted their form. Displayed in the conversation summary. |
street | no | the street address of the seeker |
city | no | the city of the seeker |
country | no | the country of the seeker |
zip | no | the zip code or postal code of the seeker |