WordPress recipes
Add BlueBot’s “Text us” button to a WordPress site, or text people from its forms.
Three recipes for WordPress. Each names its trigger and the BlueBot step, lists the fields to map and says how to test it with your own number before anyone else gets a text.
How WordPress connects
- : It works inside BlueBot with nothing else to set up.
- : A Text Hook is a BlueBot address the app posts its own webhook to. You map its fields to a recipient and a template, and each post becomes a text.
- : BlueBot’s Zapier app has a Send Text action and instant triggers for incoming texts and every change of state.
Add a “Text us” button
| Part | What it is |
|---|---|
| Trigger | A visitor taps “Text us” on your site |
| Action | WordPress acts on what BlueBot reports |
| Connects through |
Steps
- Copy the website widget’s script tag from BlueBot’s dashboard.
- Add it to every page through your theme’s header or a plugin that adds scripts.
- A visitor types their name, number and question, and BlueBot texts them from your number.
- The conversation carries on in iMessage, and you answer from your phone, your Mac or BlueBot’s inbox.
Test it
Try it once with your own number before you turn it on for anyone else.
Answer common questions with Autopilot
| Part | What it is |
|---|---|
| Trigger | A visitor’s question comes in through the button |
| Action | BlueBot’s webhook starts it, and WordPress takes the text |
| Connects through |
Steps
- Turn on Autopilot and give it your instructions and FAQ.
- It drafts a reply to each new question from what you gave it, and hands off when it isn’t sure.
- Read each draft in BlueBot’s inbox and send it, or let Autopilot send on its own once you trust it.
Map the fields
| From BlueBot | Into WordPress |
|---|---|
| From | The phone number to find the person by in WordPress. It’s in E.164 (+15555550123); search by the last 10 digits if WordPress stores numbers another way. |
| Text | The words, for a note, a row or a message. Null when the person sent only a picture. |
| Received At | When it came in, in UTC. |
| Files | Pictures and voice memos. Each url works for an hour, so copy a file you want to keep. |
| Chat ID | Set when the text came in a group chat; null for a one-to-one text. |
Test it
Text your BlueBot number from another phone and check that the step ran. BlueBot copies texts from people you’ve texted through it, unless you set Which chats to copy to Everything.
Text people who fill in a form
| Part | What it is |
|---|---|
| Trigger | A form plugin posts its webhook |
| Action | A BlueBot Text Hook turns each post into a text |
| Connects through |
Steps
- Make a Text Hook in BlueBot and copy its address.
- In a form plugin that can post a webhook, add the address to your form.
- Submit the form once, then map the name and phone fields from the payload BlueBot kept.
- Write the template, and each submission becomes a text from your number.
Map the fields
| Text Hook setting | Set it to |
|---|---|
| Recipient | The field in WordPress’s post that holds the person’s phone number, written as a path such as {{body.phone}}. |
| Text | Hi {{body.first_name}}, thanks for your message. This is Priya at Cedar Dental. I’ll text you back today about an appointment. |
| Metadata | source set to wordpress. BlueBot adds the hook’s id by itself. |
Test it
Post a sample to the hook’s address with your own number in the phone field, as below. A text arrives on your phone, and the hook’s page lists the post.
A test post shaped like WordPress’s
curl -X POST "https://usebluebot.com/h/YOUR_HOOK_TOKEN" \
-H "Content-Type: application/json" \
-d '{"phone":"+15555550123","first_name":"Maria"}'Before you turn it on
- Text only people who asked to hear from you. Anyone who replies STOP goes on your stop list, and BlueBot cancels texts to them.
- A text that can’t go yet waits with a hold rather than failing: quiet hours, your Mac away, a daily limit.
- on the integrations page says what else the two do together.