Wespoke
Documentation

Tools

Empower your assistants with API calls, database queries, and custom workflows

What is a Tool?

Tools are custom actions your AI assistant can perform during conversations. With tools, your assistant can send requests to external APIs, query databases, retrieve information, and execute operations. This transforms your assistant from a simple chatbot into a powerful business automation tool.

Tool Types

API Requests

Send HTTP requests to external REST APIs. Retrieve customer information from your CRM systems, access your reservation systems, or integrate with third-party services.

Database Queries

Send direct SQL queries to your own databases. Search customer records, check stock status, or retrieve order information.

Workflow URL

Trigger your custom workflows on platforms like Make.com, Zapier, or n8n. Automate complex multi-step processes.

WhatsApp Message

Send WhatsApp messages to the person on the call via your own Twilio account. AI composes the message content, the recipient is automatically determined from the call context.

Creating a Tool

To create a new tool:

  1. 1

    Go to Tools Page

    Navigate to the "Tools" section in the dashboard

  2. 2

    Click "New Tool" Button

    Click the "New Tool" button in the top right corner

  3. 3

    Fill in Basic Information

    Give your tool a name and add a description

  4. 4

    Select Tool Type

    Choose API request, database query, or workflow URL

  5. 5

    Complete Configuration

    Configure the required settings for your selected tool type

API Request Tool Configuration

URL

The API endpoint to send requests to

https://api.example.com/customers/search

HTTP Method

Choose from GET, POST, PUT, DELETE, or PATCH

Headers

Add Authorization, Content-Type, and custom headers

Authorization: Bearer your-api-keyContent-Type: application/json

Parameters

Define parameters that the AI needs to fill during conversations. Specify name, type (string, number, boolean), and description for each parameter.

Request Body

JSON body template for POST/PUT requests

{
  "query": "{{searchTerm}}",
  "limit": 10
}

Database Query Tool

Database Connection

Connect to PostgreSQL, MySQL, or other supported databases. Store your connection string securely.

SQL Query

Write the SQL query to execute. Use placeholders for parameters.

SELECT * FROM customers
WHERE phone = {{phoneNumber}}
LIMIT 1

⚠️ Security Warning

It is recommended to use only read (SELECT) queries. Use API endpoints for write operations like INSERT, UPDATE, DELETE.

Workflow URL Tool

Workflow URL tools allow you to trigger automations created on platforms like Make.com, Zapier, or n8n.

Webhook URL

Enter the webhook URL from your workflow platform

https://hook.make.com/xxxxxxxxxxxxx

Parameters

Define parameters to send to the workflow. These parameters will be extracted from the conversation by AI and sent to the webhook as JSON.

💡 İpucu

Test the webhook with test data in your workflow platform. Then test the tool in the Wespoke platform to ensure parameters are sent correctly.

WhatsApp Message Tool

Send WhatsApp messages during voice calls using your own Twilio account. The AI assistant composes the message and the recipient number is automatically determined from the call context.

Twilio Account SID

Your Twilio Account SID, found in your Twilio Console dashboard. Starts with 'AC'.

Twilio Auth Token

Your Twilio Auth Token, found in your Twilio Console dashboard. Keep this secret.

WhatsApp Sender Number

Your Twilio WhatsApp-enabled phone number in international format (e.g. +14155238886). You can start with the Twilio WhatsApp Sandbox for testing.

Billing Note

WhatsApp messages are sent via your Twilio account. Twilio bills you directly — there is no additional charge from the platform.

⚠️ Template Note

If the recipient hasn't messaged your WhatsApp number before, you may need to use a pre-approved template message instead of freeform text. This is a WhatsApp policy requirement.

Adding Tools to Assistants

To add your created tools to assistants:

  1. 1.Go to the assistant editing page
  2. 2.See available tools in the "Tools" section
  3. 3.Select the tools you want to add
  4. 4.Save changes and publish

Tool Testing

It is recommended to test your tools before going live:

Tool Test Interface

Each tool's detail page has a "Test" button. You can test the tool by manually entering parameters.

Assistant Test Mode

When testing your assistant, your tools are also automatically tested. You can see how the tool is triggered during conversations.

Use Cases

Appointment Management

Query available appointment times, create, cancel, or update appointments

E-commerce Support

Query order status, check product stock, provide price information

CRM Integration

Fetch customer information, add notes, create tickets

Hotel Reservation

Check room availability, calculate prices, make reservations

Notification Sending

Send emails, text messages, create notifications

Start Creating Your Tools

Equip your assistants with powerful tools and create real business value.

Manage Your ToolsAPI Documentation