AI Agents

Tool	Description	Approval
`getCurrentDatetime`	Returns the current date and time in both Gregorian and Hijri calendars. Both agents call this before any date/time reasoning.	No
`searchDocs`	Searches uploaded RAG documents for relevant information using semantic similarity. Used when a user asks about policies, procedures, or other uploaded knowledge base content.	No

Tool	Description	Approval
`scheduleEvent`	Schedules an event for the current WhatsApp contact. Requires the contact's name, a local datetime, and an event type.	No
`modifyEvent`	Modifies an existing event by ID. Can change the datetime, name, or event type. The assistant should call `getUserEvents` first to find the correct event ID.	No
`cancelEvent`	Cancels an existing event by ID. The assistant should call `getUserEvents` first to find the correct event ID.	No
`getUserEvents`	Retrieves all events for the current WhatsApp contact. Can optionally include past events. Returns event IDs, datetimes, types, statuses, and whether each event is in the future.	No

Tool	Description	Approval
`getAvailableTimeSlots`	Returns available time slots for a specific date. Supports both Gregorian and Hijri dates. Returns times in 24-hour format.	No
`searchAvailableAppointments`	Searches for available appointments across multiple days. Useful when a contact wants to find the next available slot. Can search forward and backward from a start date and filter by a preferred time slot.	No

Tool	Description	Approval
`sendInteractiveButtons`	Sends a WhatsApp interactive button message with up to 3 options. Used for confirmations or simple choices (e.g., "Confirm booking?" with Yes/No buttons).	No
`sendInteractiveList`	Sends a WhatsApp interactive list message with up to 10 sections and 10 rows per section. Used for selections with more than 3 options (e.g., choosing from a list of available time slots).	No

Tool	Description	Approval
`sendBusinessLocation`	Sends the configured business location as a WhatsApp location pin. Used when a contact asks for the address or directions. Requires business coordinates to be configured.	No

Tool	Description	Approval
`modifyEvents`	Modifies specific events by their IDs. Use when you know the exact event IDs to change. Can update datetime and/or event type for each event independently.	Yes
`modifyEventRange`	Bulk-modifies all events matching a date range. Can shift events by a number of days or weeks, change event types, and filter by weekday, phone number, or event type. Powerful for rescheduling entire weeks.	Yes

Tool	Description	Approval
`cancelEvents`	Cancels specific events by their IDs. Use when you know the exact event IDs to cancel.	Yes
`cancelEventRange`	Cancels all events matching a date range. Can filter by weekday, phone number, and event type. Use for clearing out entire date ranges.	Yes

Tool	Description	Approval
`getEventSnapshots`	Queries events across date ranges with filters. Returns events grouped by user, including event IDs, datetimes, types, and statuses. Use the returned event IDs for subsequent modify or cancel operations. Supports filtering by phone, name search, event type, and cancelled status.	No
`getAvailableSlotsBatch`	Checks availability for multiple dates at once (up to 30 dates). Returns available time slots for each date. Useful for finding open slots across a range.	No

Setting	Description
Model	The primary OpenRouter model to use
Fallback model	A backup model if the primary is unavailable
Reasoning effort	How much reasoning the model applies (none through high)
Verbosity	Response detail level (concise, medium, detailed)
Stream reasoning	Whether to stream the model's internal reasoning steps in real time
Context limit	Maximum number of conversation messages included as context
Max output tokens	Token limit for the primary model's responses
System prompt	Custom prompt for the AI Assistant (WhatsApp bot)
Agent prompt	Custom prompt for the System Agent (internal)
RAG settings	Embedding model and search threshold for document retrieval

AI Agents