> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Let chatters book meetings using the Coconut Software app

## Overview\[#UUID-6bc9ef00-e60b-72a6-0e48-a7df2c24740b_id_1500012784301_id_h_01F71P20GBH40P6JZ32YC9DYB1]

The Book A Meeting app block uses the Coconut Software app to integrate
your [Coconut Software](https://www.coconutsoftware.com/) account with
Ada! This integration lets your chatters book meetings or schedule
appointments with your team directly through your bot.

> **Note**
>
> This feature may not be included with your organization's subscription
> package. For more information, see Ada's
> [Pricing](https://www.ada.cx/pricing) page, or contact your Ada team.

![](/_fern-files/_img/eb1794ba480d86e3c6204e1c4485e3a606ff2350a77923b82f8c9a43cb4724dd.webp)

## Configure the Coconut Software app\[#UUID-6bc9ef00-e60b-72a6-0e48-a7df2c24740b_id_1500012784301_id_h_01F72245A0G8KPP7D4D59MZVYX]

Configuring the Coconut Software app happens right in the block. As with
any Answer block, drag and drop the Coconut Software block into the
build workspace of the dashboard Answers view.

> **Note**
>
> The available dates and timeslots the block displays depend on the
> availabilities you've set in your Coconut Software account.

1. Complete the mandatory configuration fields.

   > **Note**
   >
   > If you have not already done so, use Capture blocks to create
   > [variables](/scripted/docs/build-and-maintain-your-bot/personalize-conversations/get-started-with-variables)
   > with the chatter's **email**, **first name**, and **last name**
   > before serving the chatter the Book A Meeting block. Remember, it is
   > best practice to name the variables exactly as shown in the
   > following table.

   <table>
     <tbody>
       <tr>
         <td>
           **Email Address**
         </td>

         <td>
           Add the **email** variable.
         </td>
       </tr>

       <tr>
         <td>
           **First Name**
         </td>

         <td>
           Add the **first_name** variable.
         </td>
       </tr>

       <tr>
         <td>
           **Last Name**
         </td>

         <td>
           Add the **last_name** variable.
         </td>
       </tr>

       <tr>
         <td>
           **Service ID**
         </td>

         <td>
           Add a **Coconut Service ID** for the Coconut Service
           offered for this booking instance.

           > **Note**
           >
           > The Coconut App Block references only one service at a time. To offer
           > more than one service booking option to an Answer, add a unique block
           > for each service instance.
         </td>
       </tr>

       <tr>
         <td>
           **Location ID**
         </td>

         <td>
           Add the ID of the **booking event
           location**.
         </td>
       </tr>

       <tr>
         <td>
           **Coconut Software URL**
         </td>

         <td>
           Add your Coconut Software **dashboard URL**.

           **Example:** `https://ada.coconutcalendar.com`
         </td>
       </tr>
     </tbody>
   </table>

2. *\[Optional]* Click the **Select Optional Configurations**
   drop-down menu, then select an option to add it to the block.

   | Option          | Description                                                                                                                      |
   | --------------- | -------------------------------------------------------------------------------------------------------------------------------- |
   | **Date Format** | Use this field to define how the date looks to a chatter. Otherwise, the default format is *YYYY-MM-DD.*                         |
   | **Staff ID**    | Add the ID of your team member with whom the meeting is being booked. If omitted, an eligible team member is selected at random. |

3. Click the **Save Response as Variables** drop-down menu and add the
   chatter selected meeting details you wish to capture.

   | Option                        | Description                                           |
   | ----------------------------- | ----------------------------------------------------- |
   | **Selected Date**             | The meeting date selected by the chatter.             |
   | **Selected Date - Localized** | The meeting date localized to the chatter's language. |
   | **Selected Time Slot End**    | The meeting end time.                                 |
   | **Selected Time Slot Start**  | The meeting start time.                               |

4. Assign existing variables or create new variables to capture each of
   the meeting details you added in step 3.

5. Click **Save**.

The Coconut Software block is now configured and ready to use.

![](/_fern-files/_img/5ff73b067938021a159402a5d37c575423ec4620c7451e4e34dce97d70b97fc1.webp)

## Use the Coconut Software block in an Answer\[#UUID-6bc9ef00-e60b-72a6-0e48-a7df2c24740b_id_1500012784301_id_h_01F7PARAC0EPW752YH14DPRVSB]

Now that you've configured the Coconut Software block, it's time to put
it into action! Here are some pointers for using the Coconut Software
app in an Answer:

1. Start the booking process with a friendly telling the chatter what's
   going to happen next.

   ***Example:*** *"I can book a meeting for you. I just need a bit of
   info from you."*

2. Use *Capture Blocks* to record the chatter information in the
   variables you added to the configuration fields.

3. Place the Coconut Software next.

4. Save the meeting date and time as variables in the block if you need
   to use the information for any process outside of the direct
   functionality of the block; otherwise, the Coconut Software app
   organizes everything you need to set up a meeting.

## Understand the chatter experience for the Coconut Software app\[#UUID-6bc9ef00-e60b-72a6-0e48-a7df2c24740b_id_1500012784301_id_h_01F7PASEHE8B47S4ME5FPM1HZH]

The chatter experience for Coconut Software app is straight forward and
intuitive. They need only select a date from a calendar, and then an
available timeslot for that day from a list.

Once the chatter completes entering all the required contact info via
the capture blocks you set up, they :

* The Coconut Software app displays a calendar with your team's
  available dates. The chatter has simply to click a date in the
  calendar to select it, then click the *Pick a time* button.

* The chatter selects a timeslot from a list of available times for
  their chosen day.

* Once they click *Confirm,* the meeting is set.

* A confirmation email is sent to the chatter at the email address they
  provided.

![](/_fern-files/developers.ada.cx/5bee8edfda08f1ef900405f41f59207175763060f714969f2b577f190e97a4ad/ada.docs.buildwithfern.com/2025-05-28T19:49:52.708Z/versions/assets/image/uuid-f2730321-9274-81d9-3807-5322ec6e63e0.gif)

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).