{"server":"Wassenger","checked":"2026-11-22","tools":[{"name":"analyze_whatsapp_chat_messages","description":"WhatsApp chat message analysis tool. Supports delivery-status lookups and chat export. The 'device' parameter accepts a device ID (24-hex), phone number (E.164), or alias — auto-selected if the account has a single device; otherwise the tool errors with the list of available devices so you can ask the user.\n\nAvailable actions:\n- delivery_status: Check delivery and read receipts for specific outbound messages (≤30 days old)\n- export: Export chat messages in JSON, CSV, or TXT format","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["delivery_status","export"],"description":"Action to perform for WhatsApp message analysis operations"},"chat":{"type":"string","minLength":6,"maxLength":40,"description":"WhatsApp chat ID (required for export)"},"device":{"type":"string","minLength":8,"maxLength":64,"description":"Target WhatsApp device — accepts device ID (24-hex), phone number in E.164 format, or device alias. Optional: if the account has a single device, it is auto-selected; otherwise specify which one."},"fromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z?$","description":"Export period start date"},"toDate":{"$ref":"#/properties/fromDate","description":"Export period end date"},"messageIds":{"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{18,32}$","description":"WhatsApp message ID"},"minItems":1,"maxItems":20,"description":"Message IDs to check status for (required for delivery_status, max 20)"},"format":{"type":"string","enum":["json","csv","txt"],"default":"json","description":"Export format"},"includeMedia":{"type":"boolean","default":false,"description":"Include media file information in export"},"includeMetadata":{"type":"boolean","default":true,"description":"Include full message metadata in export"},"maxMessages":{"type":"number","minimum":1,"maximum":1000,"default":500,"description":"Maximum messages to export (paginated under the hood)"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"analyze_whatsapp_chats","description":"Reports and exports of the chats of a WhatsApp number.\n\nAvailable actions:\n- statistics: the team's figures for a period (7 days by default, up to 92): new, resolved and reopened chats, messages received and sent, internal notes, average time to the first reply, to each reply, to resolve and to handle a chat, what was in the inbox at the end of the period, the most used labels and a day-by-day breakdown. Add compareFromDate and compareToDate to compare with an earlier period and get the change in percent. Days are cut at midnight in the account timezone, so for whole days pass local midnights with their offset. Times are in seconds. There is no breakdown per agent or per hour.\n- export: Export chats in JSON, CSV or TXT, filtered by status and date, paging through as many chats as requested\n\nUse this tool for: weekly reports, response time reviews, backups, and feeding chat lists into another system.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["statistics","export"],"description":"Chat analysis action to perform"},"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"format":{"type":"string","enum":["json","csv","txt"],"default":"json","description":"Export format"},"limit":{"type":"number","minimum":1,"maximum":1000,"default":100,"description":"Maximum number of WhatsApp chats to export (max 1000, fetched in pages of 500)"},"status":{"type":"array","items":{"type":"string","enum":["removed","banned","archived","muted","pending","active","resolved"],"description":"Platform chat status"},"maxItems":7,"description":"Export only: filter by chat status"},"fromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"Start of the period, e.g. 2026-09-11T00:00:00+02:00. Statistics: defaults to 7 days before toDate. Export: only chats whose last message is after this date"},"toDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"End of the period. Statistics: defaults to now. Export: only chats whose last message is before this date"},"compareFromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"Statistics only: start of an earlier period to compare with. Requires compareToDate"},"compareToDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"Statistics only: end of the earlier period to compare with"},"verbosity":{"type":"string","enum":["summary","standard","full"],"default":"summary","description":"Response detail level for the json format"},"fields":{"type":"array","items":{"type":"string"},"maxItems":40,"description":"Explicit dot-path allowlist for the json format. Overrides verbosity when set."}},"required":["action","device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"create_whatsapp_template","description":"Create a WhatsApp message template and submit it to WhatsApp for review (WhatsApp Business API numbers only). It works in steps. Call it with whatever the user has given so far: if anything is missing or breaks a WhatsApp rule, it returns needsInput with the exact questions to ask, and nothing is created. When everything is valid it returns a preview and a confirmToken, still without creating anything. Show the preview; only after the user approves, call it again with the same fields plus the confirmToken. Supports text, image, video, document and location headers, body variables ({{1}} or {{first_name}}) with sample values, a footer, quick reply, URL, phone number and copy code buttons, and authentication (one-time code) templates.","inputSchema":{"type":"object","properties":{"device":{"type":"string","description":"WhatsApp Business API device ID (24 hex characters) that will own the template. Use get_whatsapp_devices to find it."},"name":{"type":"string","description":"Template name: lowercase letters, numbers and underscores, e.g. order_ready"},"language":{"type":"string","description":"WhatsApp language code of the template text, e.g. en_US, es, pt_BR"},"category":{"type":"string","enum":["MARKETING","UTILITY","AUTHENTICATION"],"description":"MARKETING (promotions and offers), UTILITY (order, account or appointment updates) or AUTHENTICATION (one-time codes)"},"header":{"type":"object","properties":{"format":{"type":"string","enum":["TEXT","IMAGE","VIDEO","DOCUMENT","LOCATION"],"description":"Header type"},"text":{"type":"string","description":"Text for a TEXT header: up to 60 characters and at most one variable"},"example":{"type":"string","description":"Sample value for the {{1}} variable of a TEXT header"},"mediaUrl":{"type":"string","description":"Public URL of a sample file: JPEG or PNG for IMAGE, MP4 for VIDEO, PDF for DOCUMENT"},"file":{"type":"string","description":"ID of an already uploaded file, instead of mediaUrl"}},"additionalProperties":false,"description":"Optional header shown above the body"},"body":{"type":"string","description":"Message body, up to 1024 characters. Mark per-message values with {{1}}, {{2}} or named variables like {{first_name}}; never at the very start or end, and never next to each other. Not used for AUTHENTICATION templates."},"bodyExamples":{"type":"object","additionalProperties":{"type":"string"},"description":"One realistic sample value per body variable, keyed by the variable: {\"1\": \"Maria\"} or {\"first_name\": \"Maria\"}. Ask the user for them; never invent them."},"footer":{"type":"string","description":"Optional footer, up to 60 characters, without variables"},"buttons":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["QUICK_REPLY","URL","PHONE_NUMBER","COPY_CODE"],"description":"Button type"},"text":{"type":"string","description":"Button label, up to 25 characters (COPY_CODE buttons have a fixed label)"},"url":{"type":"string","description":"URL the button opens. End it with {{1}} when each message needs its own ending"},"urlExample":{"type":"string","description":"Sample value for the {{1}} at the end of the URL: only that part, not the full URL"},"phoneNumber":{"type":"string","description":"Number a PHONE_NUMBER button calls, in international format, e.g. +14155550142"},"couponExample":{"type":"string","description":"Sample coupon code for a COPY_CODE button, up to 15 characters"}},"additionalProperties":false},"description":"Optional buttons: up to 10 in total, at most 2 URL, 1 PHONE_NUMBER and 1 COPY_CODE, with quick replies grouped together"},"authentication":{"type":"object","properties":{"codeExpirationMinutes":{"type":"number","description":"Minutes (1-90) until the code expires, shown in the footer"},"addSecurityRecommendation":{"type":"boolean","description":"Add \"For your security, do not share this code.\" to the text"}},"additionalProperties":false,"description":"Options for AUTHENTICATION templates only"},"confirmToken":{"type":"string","description":"Token returned with the preview. Pass it only after the user approved that exact preview."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"delete_whatsapp_file","description":"Delete an uploaded WhatsApp file permanently. This action cannot be undone and will remove the file from storage. The file will no longer be available for sending in messages.","inputSchema":{"type":"object","properties":{"fileId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"File ID (24 character hexadecimal string)"}},"required":["fileId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"delete_whatsapp_template","description":"Delete one WhatsApp message template, in one language, from a WhatsApp Business API number. It works in two steps: called without a confirmToken it only reports which template would be deleted and returns a token, writing nothing; the deletion happens on a second call carrying that token, after the user approved it. It never deletes more than the template it reported, and it asks which language when the name exists in several.","inputSchema":{"type":"object","properties":{"device":{"type":"string","description":"WhatsApp Business API device ID (24 hex characters) that owns the template"},"name":{"type":"string","description":"Name of the template to delete"},"language":{"type":"string","description":"Language code of the template to delete, e.g. es or en_US. Required when the name exists in several languages."},"confirmToken":{"type":"string","description":"Token returned with the confirmation. Pass it only after the user approved deleting that exact template."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"delete_whatsapp_web_form_submissions","description":"Delete web form submissions, or cancel a booking: delete (one), delete_many (up to 100 ids), forget_contact (every submission of one contact, the contact fields the forms wrote, and the contact's WhatsApp Forms responses, for an erasure request), or cancel_booking (the appointment a submission booked: the time is offered again, the answers stay; with message, the customer is told in the chat). The first call reports what would be erased or cancelled and a confirmToken; call again with the token once the user approved. Only the account owner's key or an admin can delete; a booking can also be cancelled by the agent who sent its link. For WhatsApp Forms (Meta WhatsApp Flows, native in-chat forms on WhatsApp Business API numbers) use send_whatsapp_flow and list_whatsapp_flows instead.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["delete","delete_many","forget_contact","cancel_booking"],"description":"What to do"},"submissionId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"delete, cancel_booking: the submission"},"message":{"type":"string","minLength":1,"maxLength":1000,"description":"cancel_booking: what to tell the customer in the chat; leave out to cancel without telling them"},"ids":{"type":"array","items":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$"},"minItems":1,"maxItems":100,"description":"delete_many: the submissions"},"contact":{"type":"string","minLength":6,"maxLength":120,"description":"forget_contact: chat ID or phone of the contact"},"device":{"type":"array","items":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$"},"minItems":1,"maxItems":10,"description":"forget_contact: only on these numbers"},"formId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"forget_contact: only this web form"},"allForms":{"type":"boolean","description":"forget_contact: across every web form"},"confirmToken":{"type":"string","minLength":8,"maxLength":64,"description":"Token from the preview, sent back once the user approved the change"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"download_whatsapp_chat_file","description":"Download the content of a received file from a WhatsApp chat. Returns the file content in the specified format: URL only (default) or base64 encoded content.","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"fileId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"File ID (24 character hexadecimal string)"},"outputFormat":{"type":"string","enum":["url","base64"],"default":"url","description":"Download format: url (download URL only) or base64 (encoded file content)"}},"required":["device","fileId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"download_whatsapp_file","description":"Download the content of an uploaded WhatsApp file. Returns the file content in the specified format: URL only (default) or base64 encoded content.","inputSchema":{"type":"object","properties":{"fileId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"File ID (24 character hexadecimal string)"},"outputFormat":{"type":"string","enum":["url","base64"],"default":"url","description":"Download format: url (download URL only) or base64 (encoded file content)"}},"required":["fileId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"export_whatsapp_chats","description":"Export WhatsApp chats list in various formats for backup, analysis, or reporting purposes.\n\nSame as analyze_whatsapp_chats with action \"export\".","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"format":{"type":"string","enum":["json","csv","txt"],"default":"json","description":"Export format"},"limit":{"type":"number","minimum":1,"maximum":1000,"default":100,"description":"Maximum number of WhatsApp chats to export (max 1000, fetched in pages of 500)"},"status":{"type":"array","items":{"type":"string","enum":["removed","banned","archived","muted","pending","active","resolved"],"description":"Platform chat status"},"maxItems":7,"description":"Export only: filter by chat status"},"fromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"Start of the period, e.g. 2026-09-11T00:00:00+02:00. Statistics: defaults to 7 days before toDate. Export: only chats whose last message is after this date"},"toDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"End of the period. Statistics: defaults to now. Export: only chats whose last message is before this date"},"compareFromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"Statistics only: start of an earlier period to compare with. Requires compareToDate"},"compareToDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"Statistics only: end of the earlier period to compare with"},"verbosity":{"type":"string","enum":["summary","standard","full"],"default":"summary","description":"Response detail level for the json format"},"fields":{"type":"array","items":{"type":"string"},"maxItems":40,"description":"Explicit dot-path allowlist for the json format. Overrides verbosity when set."}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_archived_chats","description":"Retrieve archived WhatsApp chats. Useful for accessing historical conversations and managing chat organization.\n\nSame as get_whatsapp_chats with action \"archived\".","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"limit":{"type":"number","minimum":1,"maximum":100,"default":30,"description":"Number of WhatsApp chats per call (max 100)"},"page":{"type":"number","minimum":0,"maximum":300,"default":0,"description":"Results page, starting at 0"},"sort":{"type":"string","enum":["date:asc","date:desc","lastMessage:asc","lastMessage:desc","inbound:asc"],"description":"Result order. Defaults to the API order (most recent activity first)"},"fromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z?$","description":"Start date (for by_date_range and archived actions)"},"toDate":{"$ref":"#/properties/fromDate","description":"End date (for by_date_range and archived actions)"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_assigned_chats","description":"Retrieve WhatsApp chats assigned to specific agents or departments. Essential for agent workload management and performance tracking.\n\nSame as get_whatsapp_chats with action \"assigned\".","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"agentId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Filter by assigned agent ID (for assigned action)"},"departmentId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Filter by assigned department ID (for assigned action)"},"limit":{"type":"number","minimum":1,"maximum":100,"default":30,"description":"Number of WhatsApp chats per call (max 100)"},"page":{"type":"number","minimum":0,"maximum":300,"default":0,"description":"Results page, starting at 0"},"sort":{"type":"string","enum":["date:asc","date:desc","lastMessage:asc","lastMessage:desc","inbound:asc"],"description":"Result order. Defaults to the API order (most recent activity first)"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_chat_by_id","description":"Retrieve detailed information about a specific chat using its WhatsApp ID. Includes complete metadata, assignment info, and activity details.\n\nSame as get_whatsapp_chats with action \"by_id\".","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"verbosity":{"type":"string","enum":["summary","standard","full"],"default":"summary","description":"Response detail level: summary = curated high-signal fields (default, token-lean); standard = broader set; full = complete chat objects (escape hatch)."},"fields":{"type":"array","items":{"type":"string"},"maxItems":40,"description":"Explicit dot-path allowlist, e.g. ['id','name','contact.phone','unreadCount']. Overrides verbosity when set."},"chat":{"type":"string","minLength":6,"maxLength":40,"description":"WhatsApp chat ID (e.g., 1234567890@c.us for phone numbers, 123456789000000000@g.us for groups, 123456789000000@newsletter for WhatsApp channels)"}},"required":["device","chat"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_chat_file_details","description":"Get detailed information about a specific received file from a WhatsApp chat by ID. Returns complete file metadata including sender information, chat context, media details, and download URLs.","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"fileId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"File ID (24 character hexadecimal string)"}},"required":["device","fileId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_chat_messages","description":"Retrieve WhatsApp chat messages (both inbound and outbound) for a specific device. Backed by the device-scoped Chat Messages endpoint, which requires a Platform subscription on the target device.\n\nAvailable actions:\n- recent: Latest messages in a chat (newest first by default)\n- search: Text search across messages (within a chat or device-wide)\n- date_range: Messages in a specific time window\n- by_sender: Messages sent from a specific phone number or WID\n- by_type: Messages filtered by type (text, image, video, audio, document, location, contact, etc.)\n- by_id: Fetch a specific message by its WhatsApp message ID\n- thread: Get conversation context around a specific message (N before + target + N after)\n- media: Messages containing media files\n\nThe 'device' parameter accepts a device ID (24-hex), phone number in E.164 format, or device alias (e.g., \"Sales 2\") — pass exactly what the user named in their request. If the account has a single device, omit it and it will be auto-selected. If the account has multiple devices and the user didn't name one, the tool returns an error listing available devices — ask the user which one they mean.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["recent","search","date_range","by_sender","by_type","by_id","thread","media"],"description":"Action to perform for WhatsApp message retrieval operations"},"chat":{"type":"string","minLength":6,"maxLength":40,"description":"WhatsApp chat ID. Required for all actions except by_id and search (which accepts device-wide search when chat is omitted)"},"device":{"type":"string","minLength":8,"maxLength":64,"description":"Target WhatsApp device — accepts device ID (24-hex), phone number in E.164 format, or device alias. Optional: if the account has a single device, it is auto-selected; otherwise specify which one."},"messageId":{"type":"string","pattern":"^[a-fA-F0-9]{18,32}$","description":"Specific message ID (required for by_id and thread actions)"},"limit":{"type":"number","minimum":1,"maximum":50,"default":20,"description":"Maximum messages to retrieve per request (REST API caps at 50)"},"includeMedia":{"type":"boolean","default":true,"description":"Reserved for compatibility — media is always included when present"},"sortOrder":{"type":"string","enum":["asc","desc"],"description":"Sort order by date (default: desc)"},"query":{"type":"string","minLength":1,"maxLength":100,"description":"Text to search for (required for search action)"},"fromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z?$","description":"Lower bound of the date range (maps to REST `after`)"},"toDate":{"$ref":"#/properties/fromDate","description":"Upper bound of the date range (maps to REST `before`)"},"sender":{"type":"string","minLength":8,"maxLength":16,"description":"Phone number or WID of message sender (required for by_sender action)"},"messageTypes":{"type":"array","items":{"type":"string","enum":["text","image","video","audio","document","location","contact","poll","event","sticker","reaction","system"],"description":"Type of WhatsApp message"},"description":"Types of messages to retrieve (required for by_type action)"},"contextBefore":{"type":"number","minimum":0,"maximum":20,"default":5,"description":"Messages before target message (thread action)"},"contextAfter":{"type":"number","minimum":0,"maximum":20,"default":5,"description":"Messages after target message (thread action)"},"mediaTypes":{"type":"array","items":{"type":"string","enum":["image","video","audio","document","sticker"]},"description":"Filter by specific media types (media action)"},"includeReactions":{"type":"boolean","default":true,"description":"Reserved for compatibility — reactions are returned inline by the REST API when available"},"includeQuotes":{"type":"boolean","default":false,"description":"When true, request quoted message details from the API (off by default to keep responses lean)"},"includeFileDetails":{"type":"boolean","default":true,"description":"Return full media file metadata (media action)"},"verbosity":{"type":"string","enum":["summary","standard","full"],"default":"summary","description":"Response detail level: summary = curated high-signal fields (default, token-lean); standard = broader set; full = complete message objects (escape hatch)."},"fields":{"type":"array","items":{"type":"string"},"maxItems":40,"description":"Explicit dot-path allowlist, e.g. ['id','date','flow','body']. Overrides verbosity when set."}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_chat_statistics","description":"Figures of the team for a period: chat and message volumes, response and resolution times, and what was in the inbox at the end of the period, optionally compared with an earlier period.\n\nSame as analyze_whatsapp_chats with action \"statistics\".","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"compareFromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"Statistics only: start of an earlier period to compare with. Requires compareToDate"},"compareToDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"Statistics only: end of the earlier period to compare with"},"fromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"Start of the period, e.g. 2026-09-11T00:00:00+02:00. Defaults to 7 days before toDate"},"toDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?$","description":"End of the period. Defaults to now"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_chats","description":"Comprehensive WhatsApp chat retrieval tool supporting all chat operations through a unified action-based interface. Perfect for accessing chat lists, searching conversations, filtering by various criteria, and managing chat data. Supports all WhatsApp chat retrieval operations with consistent formatting.\n\nAvailable actions:\n- recent: Most recent chats\n- unread: Chats with unread messages\n- by_status: Filter by chat status (pending, active, resolved, archived...)\n- assigned: Chats assigned to an agent or department, or to anyone\n- unassigned: Chats nobody is handling yet\n- by_contact_type: Filter by chat type (chat, group, community, channel)\n- by_id: One chat by its WhatsApp ID\n- search: Free text search over phone, name, contact, company, metadata and private notes\n- archived: Archived chats\n- by_date_range: Chats by last message, first message or last inbound message date\n\nEvery action accepts labels, labelsExclude, status and contactTypes as extra filters. To find leads that went quiet, use by_date_range with activityType \"lastInbound\" and a toDate: those are the chats where the customer has not written since then.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["recent","unread","by_status","assigned","unassigned","by_contact_type","by_id","search","archived","by_date_range"],"default":"recent","description":"Chat retrieval action to perform"},"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"limit":{"type":"number","minimum":1,"maximum":100,"default":20,"description":"Number of WhatsApp chats per call (max 100)"},"page":{"type":"number","minimum":0,"maximum":300,"default":0,"description":"Results page, starting at 0"},"sort":{"type":"string","enum":["date:asc","date:desc","lastMessage:asc","lastMessage:desc","inbound:asc"],"description":"Result order. Defaults to the API order (most recent activity first)"},"chatId":{"type":"string","minLength":6,"maxLength":40,"description":"Specific chat ID (required for by_id action)"},"status":{"type":"array","items":{"type":"string","enum":["removed","banned","archived","muted","pending","active","resolved"],"description":"Platform chat status"},"maxItems":7,"description":"Filter by chat status (required for by_status action, optional elsewhere)"},"contactTypes":{"type":"array","items":{"type":"string","enum":["chat","group","community","channel","broadcast"],"description":"Type of WhatsApp chat"},"maxItems":5,"description":"Filter by chat type (required for by_contact_type action, optional elsewhere)"},"agentId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Filter by assigned agent ID (for assigned action)"},"departmentId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Filter by assigned department ID (for assigned action)"},"query":{"type":"string","minLength":1,"maxLength":150,"description":"Free text to search for (required for search action)"},"labels":{"type":"array","items":{"type":"string","minLength":1,"maxLength":50,"description":"Label name, or \"*\" to match any label"},"maxItems":30,"description":"Only chats carrying at least one of these labels. Use [\"*\"] for any label. Cannot be combined with labelsExclude"},"labelsExclude":{"type":"array","items":{"$ref":"#/properties/labels/items"},"maxItems":30,"description":"Exclude chats carrying any of these labels. Use [\"*\"] to exclude every labelled chat"},"fromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z?$","description":"Start date (for by_date_range and archived actions)"},"toDate":{"$ref":"#/properties/fromDate","description":"End date (for by_date_range and archived actions)"},"activityType":{"type":"string","enum":["lastMessage","firstMessage","lastInbound"],"default":"lastMessage","description":"Which date the range applies to: last message of any side, first message ever, or last message received from the customer"},"verbosity":{"type":"string","enum":["summary","standard","full"],"default":"summary","description":"Response detail level: summary = curated high-signal fields (default, token-lean); standard = broader set; full = complete chat objects (escape hatch)."},"fields":{"type":"array","items":{"type":"string"},"maxItems":40,"description":"Explicit dot-path allowlist, e.g. ['id','name','contact.phone','unreadCount']. Overrides verbosity when set."}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_chats_by_contact_type","description":"Filter WhatsApp chats by contact type (individual users, groups, communities, channels). Useful for analyzing different communication patterns.\n\nSame as get_whatsapp_chats with action \"by_contact_type\".","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"contactTypes":{"type":"array","items":{"type":"string","enum":["chat","group","community","channel","broadcast"],"description":"Type of WhatsApp chat"},"maxItems":5,"description":"Filter by chat type (required for by_contact_type action, optional elsewhere)"},"limit":{"type":"number","minimum":1,"maximum":100,"default":30,"description":"Number of WhatsApp chats per call (max 100)"},"page":{"type":"number","minimum":0,"maximum":300,"default":0,"description":"Results page, starting at 0"},"sort":{"type":"string","enum":["date:asc","date:desc","lastMessage:asc","lastMessage:desc","inbound:asc"],"description":"Result order. Defaults to the API order (most recent activity first)"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_chats_by_date_range","description":"Retrieve WhatsApp chats that were active within a specific date range. Perfect for analyzing conversation patterns and generating reports.\n\nSame as get_whatsapp_chats with action \"by_date_range\".","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"fromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z?$","description":"Start date (for by_date_range and archived actions)"},"toDate":{"$ref":"#/properties/fromDate","description":"End date (for by_date_range and archived actions)"},"activityType":{"type":"string","enum":["lastMessage","firstMessage","lastInbound"],"default":"lastMessage","description":"Which date the range applies to: last message of any side, first message ever, or last message received from the customer"},"limit":{"type":"number","minimum":1,"maximum":100,"default":50,"description":"Number of WhatsApp chats per call (max 100)"},"page":{"type":"number","minimum":0,"maximum":300,"default":0,"description":"Results page, starting at 0"},"sort":{"type":"string","enum":["date:asc","date:desc","lastMessage:asc","lastMessage:desc","inbound:asc"],"description":"Result order. Defaults to the API order (most recent activity first)"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_chats_by_status","description":"Search and filter WhatsApp chats by their platform status (active, pending, resolved, etc.). Useful for workflow management and chat organization.\n\nSame as get_whatsapp_chats with action \"by_status\".","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"status":{"type":"array","items":{"type":"string","enum":["removed","banned","archived","muted","pending","active","resolved"],"description":"Platform chat status"},"maxItems":7,"description":"Filter by chat status (required for by_status action, optional elsewhere)"},"limit":{"type":"number","minimum":1,"maximum":100,"default":30,"description":"Number of WhatsApp chats per call (max 100)"},"page":{"type":"number","minimum":0,"maximum":300,"default":0,"description":"Results page, starting at 0"},"sort":{"type":"string","enum":["date:asc","date:desc","lastMessage:asc","lastMessage:desc","inbound:asc"],"description":"Result order. Defaults to the API order (most recent activity first)"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_device_details","description":"Retrieve comprehensive detailed information about a specific WhatsApp device using its ID. Returns complete device configuration, session status, metrics, and actionable insights. For WhatsApp Cloud API numbers it includes the health Meta reports: quality rating, messaging limit, payment problems, restrictions and the issues Meta lists with their fix. Use it to find out why messages are not going out.","inputSchema":{"type":"object","properties":{"deviceId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID (24 character hexadecimal string)"},"includeSettings":{"type":"boolean","default":true,"description":"Include device settings and configuration"},"includeSessionLogs":{"type":"boolean","default":false,"description":"Include recent session logs"},"includeMetrics":{"type":"boolean","default":true,"description":"Include device metrics and statistics"}},"required":["deviceId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_devices","description":"Comprehensive tool to retrieve WhatsApp devices with flexible filtering options. Supports all device query scenarios: get all devices, filter by status/session status, search by terms, get only active/online devices, etc.","inputSchema":{"type":"object","properties":{"status":{"type":"array","items":{"type":"string","enum":["invalid","banned","removed","disabled","unpaid","pending","authorized","verified","operative"],"description":"Device operational status"},"description":"Filter by device operational statuses"},"sessionStatus":{"type":"array","items":{"type":"string","enum":["online","offline","timeout","timeout_sync","conflict","blocked","error","authorize","authorizing","new","loading"],"description":"WhatsApp session connectivity status"},"description":"Filter by session connectivity statuses"},"search":{"type":"string","minLength":1,"maxLength":100,"description":"Search term: phone number, alias, or device ID"},"exactMatch":{"type":"boolean","default":false,"description":"Whether to use exact match for search (only applies when search is provided)"},"onlineOnly":{"type":"boolean","default":false,"description":"Only include devices that are currently online"},"activeOnly":{"type":"boolean","default":false,"description":"Only include active/operational devices (authorized, verified, operative)"},"minUptime":{"type":"number","minimum":0,"default":0,"description":"Minimum session uptime in seconds (for online devices)"},"limit":{"type":"number","minimum":1,"maximum":100,"default":50,"description":"Maximum number of devices to retrieve"},"page":{"type":"number","minimum":0,"default":0,"description":"Page number for pagination (0-based)"},"includeMetrics":{"type":"boolean","default":true,"description":"Include device metrics (chat counts, contacts, etc.)"},"includeSettings":{"type":"boolean","default":false,"description":"Include device settings and configuration"},"includeSessionDetails":{"type":"boolean","default":true,"description":"Include detailed session information"},"includeSessionLogs":{"type":"boolean","default":false,"description":"Include recent session logs"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_file_details","description":"Get detailed information about a specific uploaded WhatsApp file by ID. Returns complete file metadata including size, type, format, status, expiration, tags, and download URLs.","inputSchema":{"type":"object","properties":{"fileId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"File ID (24 character hexadecimal string)"}},"required":["fileId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_whatsapp_unread_chats","description":"Retrieve WhatsApp chats with unread messages. Essential for managing pending conversations and customer support.\n\nSame as get_whatsapp_chats with action \"unread\".","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"limit":{"type":"number","minimum":1,"maximum":100,"default":50,"description":"Number of WhatsApp chats per call (max 100)"},"page":{"type":"number","minimum":0,"maximum":300,"default":0,"description":"Results page, starting at 0"},"sort":{"type":"string","enum":["date:asc","date:desc","lastMessage:asc","lastMessage:desc","inbound:asc"],"description":"Result order. Defaults to the API order (most recent activity first)"},"labels":{"type":"array","items":{"type":"string","minLength":1,"maxLength":50,"description":"Label name, or \"*\" to match any label"},"maxItems":30,"description":"Only chats carrying at least one of these labels. Use [\"*\"] for any label. Cannot be combined with labelsExclude"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"health_check","description":"Comprehensive health check of the MCP server and connected WhatsApp devices.","inputSchema":{"type":"object","properties":{},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_whatsapp_flow_responses","description":"List what customers answered in a WhatsApp Form (Meta WhatsApp Flow), newest first: who answered, each question's label and value, and when. Takes the form's id from list_whatsapp_flows (not its flowId). Only keys of the account owner or an admin can read answers.","inputSchema":{"type":"object","properties":{"form_id":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"The form id (\"id\" from list_whatsapp_flows, 24 hex characters)"},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"First day, YYYY-MM-DD (UTC)"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last day, YYYY-MM-DD (UTC)"},"campaign":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"Only answers to this campaign"},"device":{"$ref":"#/properties/campaign","description":"Only answers received on this number"},"page":{"type":"integer","minimum":0,"description":"Page, from 0"},"size":{"type":"integer","minimum":1,"maximum":100,"description":"Answers per page (default 25, max 100)"}},"required":["form_id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"openWorldHint":true}},{"name":"list_whatsapp_flows","description":"List WhatsApp Flows available for a device (WABA). Returns flow id, name, status, categories and entry screen. Use this to find a flow to send.","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Target WhatsApp device ID (24 character hex string)"},"status":{"type":"string","enum":["DRAFT","PUBLISHED","DEPRECATED","THROTTLED","BLOCKED"],"description":"Filter by flow status"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"openWorldHint":true}},{"name":"list_whatsapp_templates","description":"Retrieve WhatsApp templates for a specific device (approved ones by default). Each template includes its components and the variables that must be filled in to send it. This is required for sending template-based messages.","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Target WhatsApp device ID (24 character hex string)"},"status":{"type":"string","enum":["APPROVED","REJECTED","PENDING","DELETED"],"default":"APPROVED","description":"Filter templates by status (defaults to APPROVED)"},"size":{"type":"number","minimum":1,"maximum":500,"default":500,"description":"Maximum number of templates to retrieve"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"openWorldHint":true}},{"name":"manage_whatsapp_campaign_contacts","description":"Universal WhatsApp campaign contacts management tool that handles all campaign recipient operations through action-based parameters. Supports add, remove, and search operations for campaign recipients: phone numbers and groups. Essential for WhatsApp campaign recipient management.\n\nadd keeps the recipients already on the campaign. On a campaign that sends a template (WhatsApp Cloud API numbers), give every variable its component exactly as on manage_whatsapp_campaigns create: body, header, header_location, button_url_N or button_copy_code_N, with N the buttonIndex that list_whatsapp_templates reports. Such a campaign only reaches phone numbers, not groups. On a campaign from a number linked by QR, each variable key fills the {{ key }} placeholder of the campaign message.","inputSchema":{"type":"object","properties":{"campaignId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp campaign ID"},"action":{"type":"string","enum":["search","add","remove"],"description":"Action to perform on campaign contacts"},"search":{"type":"string","maxLength":50,"description":"Search contacts by phone number, name, or group ID (for search action)"},"target":{"type":"array","items":{"type":"string"},"description":"Filter by contact target: phone number or group WhatsApp ID (for search action)"},"kind":{"type":"array","items":{"type":"string","enum":["user","group","channel"],"description":"Type of WhatsApp contact (user, group, or channel)"},"description":"Filter by contact type (for search action)"},"status":{"type":"array","items":{"type":"string","enum":["pending","processing","delivered","failed"]},"description":"Filter by delivery status (for search action)"},"page":{"type":"number","minimum":0,"default":0,"description":"Results page number (for search action)"},"size":{"type":"number","minimum":1,"maximum":1000,"default":100,"description":"Results page size (for search action)"},"contacts":{"type":"array","items":{"type":"object","properties":{"phone":{"type":"string","minLength":8,"maxLength":20,"description":"Phone number for individual contacts"},"group":{"type":"string","minLength":10,"maxLength":50,"description":"Group ID for group campaigns"},"channel":{"type":"string","minLength":10,"maxLength":50,"description":"Channel ID for channel campaigns"},"name":{"type":"string","maxLength":100,"description":"Contact display name"},"message":{"type":"string","maxLength":10000,"description":"Custom message for this contact (overrides campaign message), with the same {{ }} placeholders. Ignored on template campaigns"},"url":{"type":"string","format":"uri","maxLength":2048,"pattern":"^https?:\\/\\/","description":"Media file URL for this recipient, for a template whose header is an image, video or PDF. Use it instead of the campaign file to send a different file per recipient"},"reference":{"type":"string","maxLength":200,"description":"Reference identifier for tracking"},"variables":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[A-Za-z0-9_]+$","description":"Variable key, in lowercase. QR campaigns: the placeholder name in the message, e.g. order for {{ order }}. Template campaigns: the placeholder number or name for body variables (\"1\", \"first_name\"), or header_1, button_url_0, button_copy_code_0. Buttons are numbered from 0"},"value":{"type":"string","minLength":1,"maxLength":500,"description":"Variable value"},"component":{"type":"string","pattern":"^(body|header|header_location|button_url_(0|[1-9]\\d?)|button_copy_code_(0|[1-9]\\d?))$","description":"Required on template campaigns: the part of the template the value fills (body, header, header_location, button_url_N or button_copy_code_N, N being the buttonIndex from list_whatsapp_templates). Not used on QR campaigns"}},"required":["key","value"],"additionalProperties":false},"maxItems":30,"description":"Values for this recipient. On a QR campaign each key fills the {{ key }} placeholder of the message. On a template campaign they fill the template variables, each with its component"}},"additionalProperties":false},"description":"Contacts to add to campaign (for add action)"},"phones":{"type":"array","items":{"$ref":"#/properties/contacts/items/properties/phone"},"description":"Phone numbers to remove (for remove action)"},"groups":{"type":"array","items":{"$ref":"#/properties/contacts/items/properties/group"},"description":"Group IDs to remove (for remove action)"},"channels":{"type":"array","items":{"$ref":"#/properties/contacts/items/properties/channel"},"description":"Channel IDs to remove (for remove action)"},"wids":{"type":"array","items":{"type":"string"},"description":"WhatsApp message IDs to remove (for remove action)"}},"required":["campaignId","action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_campaigns","description":"Universal WhatsApp campaign management tool that handles all campaign operations through action-based parameters. Supports search, create, update, start, stop, and delete operations for WhatsApp bulk messaging campaigns. Perfect for comprehensive WhatsApp marketing automation.\n\nWhat a campaign sends depends on the number. Its connector, reported by get_whatsapp_devices and health_check, says which kind it is: cloud for WhatsApp Cloud API, web for a number linked by QR.\n- WhatsApp Cloud API (WABA) numbers: a pre-approved template is required, and it only reaches phone numbers, never groups. Pass template { name, language } and give each recipient the values its variables need. Read the template first with list_whatsapp_templates: every variable it reports has a location (header, body or buttons) and, for buttons, a buttonIndex starting at 0. Send each value with its component, and for a button variable use button_url_N or button_copy_code_N with that index.\n- Numbers linked by QR: a message, optionally with a file. Personalize it with placeholders: {{ name }} is the recipient's name, {{ phone }} their number, and each key in a recipient's variables fills {{ key }}. For example message \"Hi {{ name }}, your order {{ order }} has shipped\" with variables [{ key: \"order\", value: \"A-1043\" }]. Write keys and placeholders in lowercase. A placeholder a recipient has no value for disappears from their message; {{ order | on its way }} prints the text after the bar instead.\n\nTo send it: create with activate true, which needs settings.date and at least one recipient, or create first and then start, which asks for the same two. If activation fails during create, the campaign is deleted and you have to create it again.\n\nRecipients: pass them on create, up to 2000 per request. To add or remove them afterwards use manage_whatsapp_campaign_contacts. The total a campaign can hold depends on the plan, from 100 on trial to 2000.\n\nWhat it will cost: before launching a template campaign, estimate_cost gives the price Meta lists per message for each country, in costs: one line per country (or dialling code) with the category of the template and how many messages go there.\n\nPayment problems: when Meta reports one on a Cloud API number's WhatsApp Business account, the templates it sends are rejected (error 131042). A Cloud API number that needs reconnecting stops the same way, because its messages fail until it is reconnected. The three ways to send a campaign (create with activate true, update with activate true, and the start action) then refuse, say why and write nothing. Tell the user, and only repeat the call with confirmPaymentIssue true if they say the payment is already fixed or want to send anyway.\n\nThings that do not undo: delete removes a campaign for good, and stop does not recall messages already handed to WhatsApp.","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID (required for create action)"},"action":{"type":"string","enum":["search","get","create","update","start","stop","delete","estimate_cost"],"description":"Action to perform on WhatsApp campaigns"},"before":{"type":"string","format":"date-time","description":"Filter campaigns created before this date (for search action)"},"after":{"type":"string","format":"date-time","description":"Filter campaigns created after this date (for search action)"},"status":{"type":"array","items":{"type":"string","enum":["removed","failed","archived","canceled","incomplete","draft","paused","pending","processing","processed"],"description":"WhatsApp campaign status"},"description":"Filter campaigns by status (for search action)"},"owner":{"type":"array","items":{"type":"string"},"description":"Filter by owner user IDs (for search action)"},"phone":{"type":"array","items":{"type":"string","minLength":8,"maxLength":20,"description":"Phone number in E.164 format (e.g., +1234567890)"},"description":"Filter campaigns by recipient phone numbers (for search action)"},"group":{"type":"array","items":{"type":"string","minLength":10,"maxLength":50,"description":"WhatsApp group ID (e.g., 447362053576-1500000000@g.us)"},"description":"Filter campaigns by group IDs (for search action)"},"page":{"type":"number","minimum":0,"maximum":100,"default":0,"description":"Results page number (for search action)"},"size":{"type":"number","minimum":1,"maximum":100,"default":50,"description":"Results page size (for search action, max 100)"},"campaignId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp campaign ID (required for get, update, start, stop, delete actions)"},"name":{"type":"string","minLength":1,"maxLength":50,"description":"Campaign name (required for create action)"},"message":{"type":"string","minLength":2,"maxLength":10000,"description":"Campaign message, for numbers linked by QR. On a WhatsApp Cloud API number use template instead. Personalize it with {{ name }}, {{ phone }} and {{ key }} for each key in the recipients' variables"},"template":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[a-z0-9_]+$","description":"Approved template name, as listed by list_whatsapp_templates"},"language":{"type":"string","minLength":2,"maxLength":5,"description":"Template language code, e.g. es or en_US. Required: with no language the API picks one of the approved templates with that name on its own"}},"required":["name","language"],"additionalProperties":false,"description":"Pre-approved template to send. Required on WhatsApp Cloud API numbers, and not accepted on numbers linked by QR"},"form":{"anyOf":[{"anyOf":[{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9a-fA-F]{24}$"},{"type":"object","properties":{"id":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9a-fA-F]{24}$","description":"Web form ID"},"expiresIn":{"type":"string","pattern":"^\\d{1,4}[hd]$","description":"How long each link stays open once sent, 1 hour to 90 days"}},"required":["id"],"additionalProperties":false}]},{"type":"null"}],"description":"A published web form (see manage_whatsapp_web_forms) sent to every recipient, each with a link of their own minted when their message goes out. On numbers linked by QR the link replaces {{form.url}} in message, or is added at its end. On WhatsApp Cloud API numbers the template must have a form link button (manage_whatsapp_web_form_appearance, link_templates). Individual recipients only. null removes it (update)"},"file":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9a-fA-F]{24}$","description":"Uploaded file ID. On a template campaign this is the header media, and only for a template whose header is an image, video or document: on a template without a media header the API sends a header the template does not have and Meta rejects it. Upload the file first with upload_whatsapp_file_from_url"},"settings":{"type":"object","properties":{"speed":{"type":"number","enum":[0.025,0.0286,0.0333,0.04,0.05,0.0667,0.1,0.15,0.2,0.3,0.5,1,1.25,1.5,1.75,2,2.5,3,4,5],"description":"Minutes between two messages, one of the listed values. 5 is the slowest, one message every five minutes; 1 is one a minute; 0.5 about two a minute; 0.2 about four; 0.025 the fastest, about forty a minute on WhatsApp Cloud API numbers. Slower is safer against spam blocks"},"date":{"type":"string","format":"date-time","description":"When to deliver the campaign, ISO 8601. Required to activate it"}},"additionalProperties":false,"description":"Campaign delivery settings (for create/update actions)"},"contacts":{"type":"array","items":{"type":"object","properties":{"phone":{"$ref":"#/properties/phone/items","description":"Phone number for individual contacts"},"group":{"$ref":"#/properties/group/items","description":"Group ID for group campaigns"},"channel":{"type":"string","minLength":10,"maxLength":50,"description":"Channel ID for channel campaigns"},"name":{"type":"string","maxLength":100,"description":"Contact display name"},"message":{"type":"string","maxLength":10000,"description":"Custom message for this contact (overrides campaign message), with the same {{ }} placeholders. Ignored on template campaigns"},"url":{"type":"string","format":"uri","maxLength":2048,"pattern":"^https?:\\/\\/","description":"Media file URL for this recipient, for a template whose header is an image, video or PDF. Use it instead of the campaign file to send a different file per recipient"},"reference":{"type":"string","maxLength":200,"description":"Reference identifier for tracking"},"variables":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":50,"pattern":"^[A-Za-z0-9_]+$","description":"Variable key, in lowercase. QR campaigns: the placeholder name in the message, e.g. order for {{ order }}. Template campaigns: the placeholder number or name for body variables (\"1\", \"first_name\"), or header_1, button_url_0, button_copy_code_0. Buttons are numbered from 0"},"value":{"type":"string","minLength":1,"maxLength":500,"description":"Variable value"},"component":{"type":"string","pattern":"^(body|header|header_location|button_url_(0|[1-9]\\d?)|button_copy_code_(0|[1-9]\\d?))$","description":"Required on template campaigns: the part of the template the value fills (body, header, header_location, button_url_N or button_copy_code_N, N being the buttonIndex from list_whatsapp_templates). Not used on QR campaigns"}},"required":["key","value"],"additionalProperties":false},"maxItems":30,"description":"Values for this recipient. On a QR campaign each key fills the {{ key }} placeholder of the message. On a template campaign they fill the template variables, each with its component"}},"additionalProperties":false},"maxItems":2000,"description":"Campaign recipients, for the create action only. Max 2000 per request, and the total a campaign can hold depends on the plan (100 on trial, 500 to 2000 otherwise). To add or remove recipients later use manage_whatsapp_campaign_contacts"},"unsubscribe":{"type":"object","properties":{"active":{"type":"boolean","description":"Enable opt-out. Turning it off again does not remove it from a campaign that already had it"},"word":{"type":"string","minLength":2,"maxLength":30,"pattern":"^[A-Za-z0-9]+$","default":"stop","description":"Word a recipient replies to opt out"},"message":{"type":"string","minLength":10,"maxLength":500,"description":"Opt-out line appended to the campaign message, and it must contain the word. Required when active is true. Ignored on template campaigns"},"actions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string","enum":["message:send","metadata:add"],"description":"Action to perform when user unsubscribes"},"params":{"type":"object","additionalProperties":{},"description":"Action parameters"}},"required":["action","params"],"additionalProperties":false},"description":"Actions to perform when user unsubscribes"}},"required":["active"],"additionalProperties":false,"description":"Unsubscribe settings (for create/update actions)"},"activate":{"type":"boolean","default":false,"description":"Start the campaign right after creating it. Needs settings.date and at least one recipient; without them the campaign is created and left as a draft"},"confirmPaymentIssue":{"type":"boolean","description":"Only after telling the user that Meta reports a payment problem on the number, or that it needs reconnecting: true to activate or start the campaign anyway, because they say it is already fixed or reconnected, or want to send regardless"},"costs":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Two-letter country code of the recipients, e.g. MX"},"phonePrefix":{"type":"integer","minimum":1,"maximum":999,"description":"International dialling code of the recipients instead of the country, e.g. 52 for Mexico"},"category":{"type":"string","enum":["marketing","utility","authentication","authenticationInternational","service"],"description":"Category of the template, the one list_whatsapp_templates reports, in lowercase"},"quantity":{"type":"integer","minimum":1,"maximum":10000000,"description":"Number of messages"}},"required":["category","quantity"],"additionalProperties":false},"minItems":1,"maxItems":100,"description":"For estimate_cost: one line per country of the recipients, with the template category and the number of messages. Up to 100 lines"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_channel_messages","description":"Comprehensive WhatsApp channel message management tool for retrieving and managing channel content. Perfect for monitoring channel activity and accessing channel message history.\n\nAvailable actions:\n- get: Get recent messages from a specific channel with filtering options","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"action":{"type":"string","enum":["get"],"description":"Action to perform on WhatsApp channel messages"},"channelId":{"type":"string","minLength":6,"maxLength":40,"description":"WhatsApp channel ID to get messages from"},"limit":{"type":"number","minimum":1,"maximum":100,"description":"Number of recent messages to retrieve (max 100)"},"includeMedia":{"type":"boolean","description":"Include media message details"},"includeDeleted":{"type":"boolean","description":"Include deleted messages in results"},"page":{"type":"number","minimum":0,"description":"Page number for pagination (0-based)"},"sortOrder":{"type":"string","enum":["asc","desc"],"description":"Sort order by timestamp"},"fromDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z?$","description":"Get messages from this date onwards"},"toDate":{"$ref":"#/properties/fromDate","description":"Get messages up to this date"},"messageTypes":{"type":"array","items":{"type":"string","enum":["text","image","video","audio","document","location","contact","poll","event","sticker","reaction","system"]},"description":"Filter by specific message types"}},"required":["device","action","channelId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_channels","description":"Comprehensive WhatsApp channel management tool supporting all channel operations. Perfect for managing channel lifecycle, membership, and content. Supports all WhatsApp channel operations through a unified action-based interface.\n\nAvailable actions:\n- list: List and retrieve channels with filtering options\n- get: Get detailed information about a specific channel\n- create: Create new channels with optional profile images\n- update: Update existing channel information (name, description)\n- search: Search for public channels by category and keywords\n- join: Join/follow channels via invite code or URL\n- leave: Leave/unfollow channels\n- delete: Delete channels (alias for leave)\n- update_image: Update channel profile images","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"action":{"type":"string","enum":["list","get","create","update","search","join","leave","delete","update_image"],"description":"Action to perform on WhatsApp channels"},"channelId":{"type":"string","minLength":6,"maxLength":40,"description":"WhatsApp channel ID (required for get, update, leave, delete, update_image actions)"},"limit":{"type":"number","minimum":1,"maximum":250,"description":"Number of results to retrieve (max 250)"},"page":{"type":"number","minimum":0,"description":"Page number for pagination (0-based)"},"permission":{"type":"string","enum":["admin","subscriber","owner"],"description":"Filter channels by permission type (for list action)"},"include":{"type":"array","items":{"type":"string","enum":["contact","chat","stats"]},"description":"Include related entities in response"},"sort":{"type":"string","description":"Sort field and order (e.g., \"-createdAt\", \"name\")"},"searchQuery":{"type":"string","maxLength":200,"description":"Text to search for in channel names and descriptions (for search action)"},"category":{"type":"string","enum":["recommended","trending","popular","new","featured"],"description":"Category of channels to search for (for search action)"},"sortOrder":{"type":"string","enum":["asc","desc"],"description":"Sort order for search results"},"sortField":{"type":"string","enum":["creation_time","subscribers"],"description":"Field to sort search results by"},"countries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"description":"Country codes to filter channels by (e.g., [\"US\", \"GB\"])"},"name":{"type":"string","minLength":1,"maxLength":100,"description":"Channel name (required for create, optional for update)"},"description":{"type":"string","maxLength":2048,"description":"Channel description (up to 2048 characters)"},"uploadImage":{"type":"boolean","description":"Whether to upload a profile image (for create action)"},"imageSource":{"type":"string","enum":["url","base64"],"description":"Source type for channel image"},"imageUrl":{"type":"string","format":"uri","description":"URL of image to use as channel profile picture (JPG or PNG, max 1MB)"},"imageData":{"type":"string","description":"Base64-encoded image data (JPG or PNG, max 1MB)"},"joinMethod":{"type":"string","enum":["code","url"],"description":"Method to join the channel (for join action)"},"inviteCode":{"type":"string","description":"Channel invitation code (required if joinMethod is \"code\")"},"inviteUrl":{"type":"string","format":"uri","description":"Channel invitation URL (required if joinMethod is \"url\")"}},"required":["device","action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_chat","description":"Change a WhatsApp chat in the team inbox without sending anything to the customer: hand it to a teammate or department, add or remove labels, resolve or reopen it, leave an internal note, or mark it read or unread. The customer sees none of it. Your team sees the change, and your account's chat webhooks are notified.\n\nAvailable actions:\n- assign: give the chat to agentId, agentEmail or departmentId (departments need a plan that includes them). A pending chat becomes active.\n- unassign: take the chat off its agent and department. It goes back to pending.\n- add_labels / remove_labels: the labels must already exist on the number, create them first with manage_whatsapp_labels. The chat keeps any label you do not mention.\n- resolve: close the conversation.\n- reopen: back to active if someone owns the chat, pending otherwise.\n- add_note: private note only your team can see (2 to 6000 characters). authorId writes it as that teammate.\n- mark_read / mark_unread: marking a resolved chat as unread reopens it.\n\nTo write to the customer, use send_whatsapp_message instead.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["assign","unassign","add_labels","remove_labels","resolve","reopen","add_note","mark_read","mark_unread"],"description":"What to change on the chat"},"device":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp number (device) ID the chat belongs to"},"chat":{"type":"string","pattern":"^(\\+?[0-9]{8,15}|[0-9-]{5,40}@(c\\.us|g\\.us|lid|newsletter|broadcast)|[A-Z]{2}\\.(ENT\\.)?[A-Za-z0-9]{1,128}@bsuid)$","description":"The chat: a phone number in international format, or its WhatsApp chat ID as returned by get_whatsapp_chats"},"agentId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"Teammate user ID to assign the chat to (for assign)"},"agentEmail":{"type":"string","format":"email","minLength":5,"maxLength":100,"description":"Teammate email to assign the chat to, instead of agentId (for assign)"},"departmentId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"Department ID to assign the chat to (for assign). Look it up with manage_whatsapp_departments"},"labels":{"type":"array","items":{"type":"string","minLength":1,"maxLength":30},"minItems":1,"maxItems":40,"description":"Label names (for add_labels and remove_labels)"},"note":{"type":"string","minLength":2,"maxLength":6000,"description":"Internal note text, WhatsApp formatting allowed (for add_note)"},"authorId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"Teammate user ID the note is written as. Defaults to the API key owner (for add_note)"}},"required":["action","device","chat"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_contact_actions","description":"Manage WhatsApp contact blocking and unblocking operations. Handle contact blocking status with action-based operations to control message reception from specific contacts. Contacts are identified by phone number in E.164 format, not by WhatsApp ID.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["block","unblock"],"description":"Action to perform on WhatsApp contact blocking/unblocking"},"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"contacts":{"type":"array","items":{"type":"string","minLength":8,"maxLength":16,"description":"Phone number in E.164 format (e.g., +1234567890)"},"minItems":1,"maxItems":50,"description":"Array of contact phone numbers in E.164 format to block or unblock (max 50)"}},"required":["action","device","contacts"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_contacts","description":"Comprehensive WhatsApp contacts management with action-based operations. Supports listing, searching, creating, updating, deleting contacts, bulk operations, and metadata management. All contact operations including CRUD, filtering, pagination, and metadata handling in one unified tool.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","get","create","update","delete","bulk_create","update_metadata","upsert_metadata"],"description":"Action to perform on WhatsApp contacts"},"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"contactWid":{"type":"string","minLength":6,"maxLength":40,"description":"WhatsApp contact ID (required for get, update, delete, update_metadata, upsert_metadata actions)"},"limit":{"type":"number","minimum":1,"maximum":200,"default":50,"description":"Number of contacts to retrieve (max 200, for list action)"},"page":{"type":"number","minimum":0,"default":0,"description":"Page number for pagination (0-based, for list action)"},"search":{"type":"string","maxLength":150,"description":"Search contacts by name, surname, phone, email, company, address, or notes (for list action)"},"type":{"type":"array","items":{"type":"string","enum":["personal","business","user","group","channel","private"],"description":"Contact type filter"},"description":"Filter contacts by type (for list action)"},"status":{"type":"array","items":{"type":"string","enum":["active","blocked"],"description":"Contact status"},"description":"Filter contacts by status (for list action)"},"owner":{"type":"array","items":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Agent ID (24 character hex string)"},"description":"Filter contacts assigned to specific agents (for list action)"},"phone":{"anyOf":[{"type":"string","minLength":8,"maxLength":20,"description":"Phone number in E.164 format (e.g., +1234567890)"},{"type":"array","items":{"$ref":"#/properties/phone/anyOf/0"}}],"description":"Phone number for create action, or array of phone numbers for list filtering"},"wid":{"type":"array","items":{"$ref":"#/properties/contactWid"},"description":"Filter contacts by WhatsApp IDs (for list action)"},"metadataKey":{"type":"array","items":{"type":"string","minLength":1,"maxLength":30},"description":"Filter contacts with specific metadata keys (for list action)"},"metadataValue":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"description":"Filter contacts with specific metadata values (for list action)"},"after":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z?$","description":"Filter contacts created after this date (for list action)"},"before":{"$ref":"#/properties/after","description":"Filter contacts created before this date (for list action)"},"updatedAfter":{"$ref":"#/properties/after","description":"Filter contacts updated after this date (for list action)"},"updatedBefore":{"$ref":"#/properties/after","description":"Filter contacts updated before this date (for list action)"},"include":{"type":"array","items":{"type":"string","enum":["chat"]},"description":"Include related entities in response"},"sort":{"type":"string","description":"Sort field and order (e.g., \"-createdAt\", \"name\", for list action)"},"verbosity":{"type":"string","enum":["summary","standard","full"],"default":"summary","description":"Response detail level for list/get: summary = curated high-signal fields (default, token-lean); standard = broader set; full = complete contact objects (escape hatch)."},"fields":{"type":"array","items":{"type":"string"},"maxItems":40,"description":"Explicit dot-path allowlist, e.g. ['wid','phone','info.email']. Overrides verbosity when set."},"name":{"type":"string","maxLength":30,"description":"Contact first name (for create, update actions)"},"surname":{"type":"string","maxLength":50,"description":"Contact surname/last name (for create, update actions)"},"title":{"type":"string","maxLength":15,"description":"Contact title (Mr., Mrs., Dr., etc., for create, update actions)"},"kind":{"type":"string","enum":["personal","business","private"],"description":"Contact category (for create, update actions)"},"gender":{"type":"string","enum":["male","female","other"],"description":"Contact gender (for create, update actions)"},"altPhone":{"$ref":"#/properties/phone/anyOf/0","description":"Alternative phone number (for create, update actions)"},"email":{"type":"string","format":"email","maxLength":100,"description":"Contact email address (for create, update actions)"},"description":{"type":"string","maxLength":100,"description":"Contact description (for create, update actions)"},"birthday":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Contact birthday in YYYY-MM-DD format (for create, update actions)"},"timezone":{"type":"string","maxLength":40,"description":"Contact timezone (for create, update actions)"},"address":{"type":"string","maxLength":100,"description":"Contact address (for create, update actions)"},"city":{"type":"string","maxLength":30,"description":"Contact city (for create, update actions)"},"postalCode":{"type":"string","maxLength":20,"description":"Contact postal code (for create, update actions)"},"country":{"type":"string","minLength":2,"maxLength":2,"description":"Contact country 2-letter ISO code (for create, update actions)"},"currency":{"type":"string","minLength":3,"maxLength":3,"description":"Contact currency 3-letter ISO code (for create, update actions)"},"notes":{"type":"string","maxLength":3000,"description":"Private notes about the contact (for create, update actions)"},"companyName":{"type":"string","maxLength":50,"description":"Company name (for create, update actions)"},"companyCode":{"type":"string","maxLength":50,"description":"Company code (for create, update actions)"},"companyTaxId":{"type":"string","maxLength":30,"description":"Company tax ID (for create, update actions)"},"companyRole":{"type":"string","maxLength":30,"description":"Contact role in company (for create, update actions)"},"companyPhone":{"$ref":"#/properties/phone/anyOf/0","description":"Company phone number (for create, update actions)"},"companyWebsite":{"type":"string","format":"uri","maxLength":100,"description":"Company website (for create, update actions)"},"companyEmail":{"type":"string","format":"email","maxLength":100,"description":"Company email (for create, update actions)"},"companyCountry":{"type":"string","minLength":2,"maxLength":2,"description":"Company country 2-letter ISO code (for create, update actions)"},"crm":{"type":"string","maxLength":50,"description":"CRM system name (for create, update actions)"},"crmRef":{"type":"string","maxLength":500,"description":"CRM reference ID or URL (for create, update actions)"},"metadata":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":30,"pattern":"^[a-zA-Z0-9_]+$","description":"Metadata key (alphanumeric and underscore characters only)"},"value":{"type":"string","maxLength":300,"description":"Metadata value (up to 300 characters)"}},"required":["key","value"],"additionalProperties":false},"maxItems":30,"description":"Contact metadata key-value pairs (for create, update, update_metadata, upsert_metadata actions)"},"assign":{"$ref":"#/properties/owner/items","description":"Assign contact to specific agent (for create action)"},"upsert":{"type":"boolean","default":false,"description":"Update the contact if it already exists instead of failing with 409 (for create and bulk_create actions)"},"removeFields":{"type":"array","items":{"type":"string"},"description":"Fields to remove/clear from contact (for update action)"},"contacts":{"type":"array","items":{"type":"object","properties":{"phone":{"$ref":"#/properties/phone/anyOf/0"},"name":{"type":"string","maxLength":30},"surname":{"type":"string","maxLength":50},"email":{"type":"string","format":"email","maxLength":100},"companyName":{"type":"string","maxLength":50},"kind":{"$ref":"#/properties/kind","description":"Contact kind/category"},"metadata":{"type":"array","items":{"$ref":"#/properties/metadata/items"},"maxItems":30},"assign":{"$ref":"#/properties/owner/items","description":"Agent ID (24 character hex string)"},"upsert":{"type":"boolean","default":false}},"required":["phone"],"additionalProperties":false},"minItems":1,"maxItems":1000,"description":"Array of contacts to create (max 1000, for bulk_create action)"}},"required":["action","device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_deal_notes","description":"Comprehensive WhatsApp deal note management tool supporting all note operations. A note is what somebody wrote on a sales deal; a note that carries a due date IS a task. Perfect for managing sales notes, tracking tasks, and attaching files to deals. Supports both standalone notes and comments nested under deal history events.\n\nAvailable actions:\n- list: Retrieve all notes for a deal with filtering and metadata\n- create: Create a new note (optionally as a task with due date, or as a comment on a deal event)\n- update: Update note text, due date, completion status, or file attachments\n- delete: Remove a note (requires confirmation)\n\nNote: The Sales Funnel API is available on the Platform Professional subscription and above. Write endpoints return HTTP 403 when the account's plan does not include it; read endpoints are deliberately NOT plan-gated. Restricted agents (plain agent role) only ever receive their own deals, regardless of filters.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","create","update","delete"],"description":"Action to perform on deal notes"},"dealId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Deal ID (required for all actions)"},"noteId":{"$ref":"#/properties/dealId","description":"Note ID (required for update and delete)"},"text":{"type":"string","minLength":1,"maxLength":2000,"description":"Note body (required for create, optional for update)"},"dueAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 date-time string. A note that has one IS a task. On update, passing null turns the task back into a plain note."},"done":{"type":"boolean","description":"Completes the task (true) or reopens it (false). Update only."},"event":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Id of one of the deal's own history events. Create only, set at birth and never moved. Makes the note a comment nested under that event."},"files":{"type":"array","items":{"$ref":"#/properties/dealId"},"maxItems":3,"description":"Ids of previously uploaded files to attach. Upload them first with the file-upload tools (POST /files). On BOTH create and update this means the COMPLETE list the note carries afterwards, never a delta: ids missing from the list are detached, and an empty array [] removes all of them. Accepted attachment types: images (jpeg, png, webp), PDF, Word, Excel, PowerPoint, plain text and markdown."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Maximum number of notes to return (1-200, default 50). List only."},"skip":{"type":"integer","minimum":0,"description":"Number of notes to skip (>= 0). List only."},"confirmDeletion":{"type":"boolean","description":"Confirmation flag required for delete action"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_deals","description":"Comprehensive WhatsApp sales funnel deal management tool. A deal is one sales opportunity tied to a WhatsApp contact, sitting in one stage of one pipeline. Supports listing, retrieving, creating, updating, archiving, moving between stages, linking to chats, and fetching event history.\n\nAvailable actions:\n- list: Retrieve deals with rich filtering (pipeline, stage, status, agent, contact, device, stalled, chatStatus, unread, updatedAfter/Before, pagination)\n- get: Retrieve a single deal by ID\n- create: Create a new deal (requires pipeline, device, contactWid)\n- update: Update deal fields (title, amount, currency, agent, department) - stage moves are NOT here, use move_stage\n- archive: Archive a deal (frees the contact's open-deal slot, preserves as sales history)\n- move_stage: Move a deal to another stage (requires previousStage for atomic compare-and-swap)\n- link_chat: Link a deal to a WhatsApp conversation by contactWid\n- events: Fetch deal event history (limit, skip)\n\nImportant notes:\n1. move_stage requires previousStage - the stage the client last saw. The server performs an atomic compare-and-swap and answers 409 when it no longer matches. Always read the deal first (action: 'get') and pass its current stage value.\n2. Only ONE open deal may exist per contact per pipeline. The API answers 409 otherwise, and the check spans the @c.us/@lid identity equivalence.\n3. Restricted agents (plain agent role) only ever see their own deals, regardless of filters.\n4. Write operations (create, update, archive, move_stage, link_chat) require the Professional plan or above. Read operations (list, get, events) are not plan-gated.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","get","create","update","archive","move_stage","link_chat","events"],"description":"Action to perform on deals"},"dealId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Deal ID (required for get, update, archive, move_stage, link_chat, events)"},"pipeline":{"$ref":"#/properties/dealId","description":"Filter by pipeline ID"},"stage":{"type":"string","description":"Stage ID within the pipeline"},"status":{"type":"string","enum":["open","won","lost","archived"],"description":"Deal status filter (defaults to open)"},"agent":{"anyOf":[{"$ref":"#/properties/dealId"},{"type":"null"}],"description":"Assigned agent user ID. Filter value on list; on update, pass null to unassign"},"unassigned":{"type":"boolean","description":"Only deals with no agent (cannot be combined with agent)"},"contact":{"type":"string","minLength":5,"maxLength":50,"pattern":"@(c\\.us|lid|g\\.us|newsletter|broadcast)$","description":"Deals for one contact (spans @c.us/@lid identity equivalence)"},"device":{"anyOf":[{"$ref":"#/properties/dealId"},{"type":"array","items":{"$ref":"#/properties/dealId"}}],"description":"WhatsApp device ID. A single ID when creating a deal; one or more IDs when filtering a list"},"stalled":{"type":"string","enum":["true","false","sla","1w","1m","3m","6m"],"description":"Deals stuck in their stage (requires pipeline)"},"updatedAfter":{"type":"string","format":"date-time","description":"ISO 8601 date-time, e.g. 2026-08-01T00:00:00.000Z (half-open range [after, before))"},"updatedBefore":{"type":"string","format":"date-time","description":"ISO 8601 date-time, e.g. 2026-08-01T00:00:00.000Z (half-open range [after, before))"},"chatStatus":{"type":"string","enum":["removed","banned","archived","muted","pending","active","resolved","none"],"description":"State of the deal's WhatsApp conversation (requires pipeline, only for open deals)"},"unread":{"type":"boolean","description":"Only deals whose conversation has unread messages"},"page":{"type":"integer","minimum":1,"description":"Page number (1-based)"},"size":{"type":"integer","minimum":1,"maximum":100,"description":"Page size (default 50)"},"contactWid":{"$ref":"#/properties/contact","description":"WhatsApp ID of the contact (required for create and link_chat)"},"chatWid":{"$ref":"#/properties/contact","description":"WhatsApp ID of the chat the deal was created from"},"title":{"type":"string","minLength":1,"maxLength":120,"description":"Deal title (defaults to contact name)"},"amount":{"anyOf":[{"type":"number","minimum":0,"maximum":999999999},{"type":"null"}],"description":"Deal amount. On update, pass null to clear it"},"currency":{"anyOf":[{"type":"string","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$","description":"3-letter uppercase ISO 4217 currency code"},{"type":"null"}],"description":"ISO 4217 currency code. Defaults to the pipeline currency; on update, pass null to clear it"},"department":{"anyOf":[{"$ref":"#/properties/dealId"},{"type":"null"}],"description":"Department ID. On update, pass null to clear it"},"card":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120,"description":"Display name on the card"},"phone":{"type":"string","minLength":1,"maxLength":30,"description":"Phone number on the card"},"avatarUrl":{"type":"string","format":"uri","maxLength":500,"description":"Avatar URL for the card"}},"required":["name","phone","avatarUrl"],"additionalProperties":false,"description":"Display-only card seed"},"previousStage":{"$ref":"#/properties/dealId","description":"The stage the client last saw (required for move_stage). Must be the current stage value from a prior get. Server answers 409 if stale."},"lostReason":{"type":"string","minLength":1,"maxLength":60,"description":"Reason for losing the deal (only meaningful when moving to a lost stage)"},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Number of events to return (default 50)"},"skip":{"type":"integer","minimum":0,"description":"Number of events to skip"},"confirmDeletion":{"type":"boolean","description":"Confirm deal archiving (required for archive action)"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_departments","description":"Comprehensive WhatsApp department management tool supporting all department operations. Perfect for organizing team structure, managing agent assignments, and customizing department appearance. Supports all WhatsApp department operations through a unified action-based interface.\n\nAvailable actions:\n- list: List and retrieve all departments with complete information\n- create: Create new departments with agents, colors, and icons\n- update: Update existing department information and agent assignments\n- delete: Delete departments (removes department but preserves agent assignments)","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"action":{"type":"string","enum":["list","create","update","delete"],"description":"Action to perform on WhatsApp departments"},"departmentId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Department ID (required for update, delete actions)"},"name":{"type":"string","minLength":2,"maxLength":25,"description":"Department name (required for create, optional for update)"},"color":{"type":"string","enum":["ruby","tomato","orange","sunflower","bubble","rose","poppy","rouge","raspberry","purple","lavender","violet","pool","emerald","kelly","apple","turquoise","aqua","gold","latte","cocoa","iron"],"description":"Department color for visual identification"},"icon":{"type":"string","enum":["briefcase","users","user-tie","chart-bar","clipboard-list","comments","headset","user-cog","user-edit","user-friends","laptop-code","network-wired","building","handshake","address-book","layer-group","project-diagram","calendar-check","clipboard-check","tasks","chart-pie","hands-helping","user-shield","user-secret","user-graduate","landmark","archive"],"description":"Department icon identifier"},"description":{"type":"string","maxLength":300,"description":"Department description (max 300 characters)"},"agents":{"type":"array","items":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Agent ID (24 character hex string)"},"minItems":1,"maxItems":30,"description":"Array of agent IDs to include in the department (required for create, optional for update)"}},"required":["device","action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_group_participants","description":"Universal WhatsApp group participants management tool that handles all participant operations through action-based parameters. Supports add, remove, promote, demote, and approval management operations. Essential for WhatsApp group moderation.","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"groupId":{"type":"string","minLength":10,"maxLength":50,"description":"WhatsApp group ID"},"action":{"type":"string","enum":["add","remove","promote","demote","get_pending","approve","reject"],"description":"Action to perform on group participants"},"participants":{"type":"array","items":{"type":"object","properties":{"phone":{"type":"string","minLength":8,"maxLength":20,"description":"Phone number in E.164 format (e.g., +1234567890)"},"admin":{"type":"boolean","default":false,"description":"Whether this participant should be added as a group admin"}},"required":["phone"],"additionalProperties":false},"description":"Participants to add with admin status (for add action)"},"phones":{"type":"array","items":{"$ref":"#/properties/participants/items/properties/phone"},"description":"Phone numbers of participants (for remove, promote, demote, approve, reject actions)"},"all":{"type":"boolean","description":"Apply action to all participants/pending members (for remove, approve, reject actions)"}},"required":["device","groupId","action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_groups","description":"Universal WhatsApp group management tool that handles all group operations through action-based parameters. Supports search, create, update, join, leave, and invite management operations. Perfect for comprehensive WhatsApp group administration.","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"action":{"type":"string","enum":["search","get","create","update","join","leave","get_invite","revoke_invite"],"description":"Action to perform on WhatsApp groups"},"kind":{"type":"array","items":{"type":"string","enum":["group","broadcast","community","channel"],"description":"Group chat type filter"},"description":"Filter groups by type (for search action)"},"page":{"type":"number","minimum":0,"default":0,"description":"Results page number (for search action)"},"size":{"type":"number","minimum":1,"maximum":500,"default":100,"description":"Results page size (for search action)"},"search":{"type":"string","maxLength":150,"description":"Search groups by name or description (for search action)"},"status":{"type":"array","items":{"type":"string","enum":["active","archived","muted"]},"description":"Filter groups by status (for search action)"},"include":{"type":"array","items":{"type":"string","enum":["participants","metadata","lastMessage","pendingMembers"]},"description":"Include additional data in response"},"sort":{"type":"string","description":"Sort field and order (for search action)"},"groupId":{"type":"string","minLength":10,"maxLength":50,"description":"WhatsApp group ID (required for get, update, leave, get_invite, revoke_invite actions)"},"name":{"type":"string","minLength":1,"maxLength":100,"description":"Group name (required for create action)"},"description":{"type":"string","maxLength":500,"description":"Group description (for create/update actions)"},"participants":{"type":"array","items":{"type":"object","properties":{"phone":{"type":"string","minLength":8,"maxLength":20,"description":"Phone number in E.164 format (e.g., +1234567890)"},"admin":{"type":"boolean","default":false,"description":"Whether this participant should be added as a group admin"}},"required":["phone"],"additionalProperties":false},"description":"Group participants (required for create action)"},"permissions":{"type":"object","properties":{"edit":{"type":"string","enum":["all","admins"],"description":"Group settings edit permissions"},"send":{"$ref":"#/properties/permissions/properties/edit","description":"Group message publication permissions"},"invite":{"$ref":"#/properties/permissions/properties/edit","description":"Group invite new participants permissions"},"approval":{"type":"boolean","description":"Group new participant approval required by administrators"}},"additionalProperties":false,"description":"Group permissions and settings (for create/update actions)"},"ephemeral":{"type":"string","enum":["off","24h","7d","90d"],"description":"Ephemeral messages duration (for create/update actions)"},"code":{"type":"string","minLength":10,"maxLength":100,"description":"Group invitation code (for join action)"},"url":{"type":"string","format":"uri","description":"Group invitation URL (for join action)"},"remove":{"type":"boolean","default":true,"description":"Remove group from chat list after leaving (for leave action)"}},"required":["device","action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_labels","description":"Comprehensive WhatsApp label management tool supporting all label operations. Perfect for organizing conversations with color-coded categories and managing chat organization systems. Supports both WhatsApp Business and platform-specific labels.\n\nAvailable actions:\n- list: Retrieve all available labels with filtering and metadata\n- create: Create new labels with custom colors and descriptions\n- update: Update existing label colors and descriptions\n- delete: Remove labels and cleanup associated chats","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"action":{"type":"string","enum":["list","create","update","delete"],"description":"Action to perform on WhatsApp labels"},"name":{"type":"string","minLength":1,"maxLength":30,"description":"Label name (required for create, update, delete actions)"},"includeMetadata":{"type":"boolean","description":"Include additional label metadata like scope and active status"},"filterByScope":{"type":"string","enum":["chat","wa"],"description":"Filter labels by scope for list action"},"activeOnly":{"type":"boolean","description":"Only return active labels (for list action)"},"color":{"type":"string","enum":["ruby","tomato","orange","sunflower","bubble","rose","poppy","rouge","raspberry","purple","lavender","violet","pool","emerald","kelly","apple","turquoise","aqua","gold","latte","cocoa","iron"],"description":"Label color from predefined palette (required for create, optional for update)"},"description":{"type":"string","minLength":2,"maxLength":100,"description":"Label description (optional for create, required for update)"},"confirmDeletion":{"type":"boolean","description":"Confirm label deletion and removal from all chats/contacts (required for delete action)"}},"required":["device","action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_message_interactions","description":"Manage WhatsApp message interactions including replies, forwards, reactions, and poll voting. Handle all message interaction operations with action-based approach for comprehensive message engagement functionality.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["reply","forward","reaction","vote"],"description":"Action to perform for WhatsApp message interactions"},"chat":{"type":"string","minLength":6,"maxLength":40,"description":"WhatsApp chat ID (e.g., 1234567890@c.us for phone numbers, 123456789000000000@g.us for groups, 123456789000000@newsletter for WhatsApp channels)"},"message":{"type":"string","minLength":1,"maxLength":15000,"description":"Reply message content (required for reply action)"},"quote":{"type":"string","pattern":"[a-fA-F0-9]{18,32}","description":"Message ID to reply to (required for reply action)"},"selectId":{"type":"string","maxLength":50,"description":"ID of selected button/list option when replying to interactive messages (for reply action)"},"forward":{"type":"object","properties":{"message":{"type":"string","pattern":"[a-fA-F0-9]{18,32}","description":"Message ID to forward"},"chat":{"type":"string","description":"Source chat ID where the message is located"}},"additionalProperties":false,"description":"Forward message details (required for forward action)"},"reaction":{"type":"string","minLength":1,"maxLength":10,"description":"Emoji reaction to send, use \"-\" to remove reaction (required for reaction action)"},"reactionMessage":{"type":"string","pattern":"[a-fA-F0-9]{18,32}","description":"Message ID to react to (required for reaction action)"},"vote":{"type":"object","properties":{"message":{"type":"string","pattern":"[a-fA-F0-9]{18,32}","description":"Poll message ID to vote on"},"options":{"type":"array","items":{"type":"number","minimum":0},"minItems":0,"description":"Option indices to vote for (empty array to remove all votes)"}},"additionalProperties":false,"description":"Vote details (required for vote action)"},"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Target WhatsApp device ID (24 character hex string) used for message delivery. Only required if you have multiple WhatsApp numbers connected. Use MCP tool \"get_whatsapp_devices\" to retrieve a list of available devices."},"agent":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Agent ID (24 character hex string)"},"reference":{"type":"string","minLength":1,"maxLength":150,"description":"Custom reference ID for message tracking"},"idempotencyKey":{"type":"string","minLength":6,"maxLength":36,"description":"Your unique key for this message, 6 to 36 characters (a UUID works). Reuse the same key when retrying the same message: the API then answers 409 Conflict with the id of the message already created instead of sending it twice. Use a new key for every different message."}},"required":["action","chat"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_pipelines","description":"Comprehensive sales pipeline management tool for the WhatsApp sales funnel (CRM). A pipeline is a sales board: an ordered list of stages that deals move through, optionally fed by specific WhatsApp numbers. Use it to set up sales boards, inspect their configuration and read their headline numbers.\n\nAvailable actions:\n- list: Retrieve all sales pipelines of the account, optionally only those fed by one device\n- get: Retrieve a single pipeline with its full stage configuration\n- create: Create a new pipeline with stages, entry rules and behaviour settings\n- update: Update pipeline properties, stages, lost reasons or settings\n- delete: Remove a pipeline (refused with 409 while it still holds open deals)\n- summary: Per-stage deal counts and open amount totals for the board, plus won and lost totals for the last 30 days\n\nStage ordering matters: a pipeline requires at least one open, one won and one lost stage, and the won and lost stages must come AFTER all the open ones, because a deal advances to the next open stage by position. When no stages are supplied on create, a sensible default ladder is seeded.\n\nNote: the sales funnel is available on the Platform Professional subscription and above. Write operations answer 403 on a plan without it, while reads stay available so an account that downgrades keeps access to its funnel data.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","get","create","update","delete","summary"],"description":"Action to perform on WhatsApp sales pipelines"},"pipelineId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Pipeline ID (required for get, update, delete and summary actions)"},"device":{"$ref":"#/properties/pipelineId","description":"WhatsApp device ID: only return pipelines fed by this device (for list action)"},"name":{"type":"string","minLength":2,"maxLength":30,"description":"Pipeline name (required for create action)"},"description":{"type":"string","minLength":0,"maxLength":300,"description":"Pipeline description"},"color":{"type":"string","minLength":1,"maxLength":30,"description":"Pipeline color name used for quick identification"},"icon":{"type":"string","enum":["funnel-dollar","filter","chart-line","handshake","money-bill-wave","bullseye","flag-checkered","coins","chart-pie","briefcase"],"description":"Pipeline icon identifier. Defaults to funnel-dollar"},"devices":{"type":"array","items":{"$ref":"#/properties/pipelineId"},"maxItems":50,"description":"WhatsApp device IDs that feed this pipeline. An empty array means all the account devices"},"currency":{"anyOf":[{"type":"string","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$"},{"type":"null"}],"description":"ISO 4217 currency code for deal amounts. Defaults to the account currency; on update, pass null to clear it back to that default"},"entry":{"type":"object","properties":{"mode":{"type":"string","enum":["manual","filter","all"],"description":"How chats enter this pipeline: manual, filter or all"},"filters":{"type":"object","properties":{"labels":{"type":"array","items":{"type":"string","minLength":1,"maxLength":40},"maxItems":20,"description":"Chat labels that make a chat enter the pipeline"},"type":{"type":"array","items":{"type":"string","enum":["chat","group","channel","broadcast"]},"maxItems":4,"description":"Chat types that make a chat enter the pipeline"}},"additionalProperties":false,"description":"Entry filters, only used when mode is filter"}},"additionalProperties":false,"description":"Entry rule configuration: how chats enter this pipeline"},"stages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":40,"description":"Stable stage identifier. Assigned by the server when omitted. On update, a stage matching a stored id is merged and omitted fields are preserved"},"name":{"type":"string","minLength":1,"maxLength":30,"description":"Stage name"},"color":{"type":"string","minLength":1,"maxLength":30,"description":"Stage color name used for quick identification"},"position":{"type":"integer","minimum":0,"maximum":99,"description":"Stage order position. Derived from the array order when omitted"},"kind":{"type":"string","enum":["open","won","lost"],"description":"Stage kind. The won and lost stages must come after all the open ones"},"slaDays":{"anyOf":[{"type":"integer","minimum":1,"maximum":365},{"type":"null"}],"description":"Maximum days a deal may stay in this stage before being flagged as stalled"},"labelMap":{"anyOf":[{"type":"string","minLength":1,"maxLength":40},{"type":"null"}],"description":"Chat label name mapped to this stage"},"actions":{"type":"object","properties":{"assignAgent":{"anyOf":[{"$ref":"#/properties/pipelineId"},{"type":"null"}],"description":"Agent to assign when a deal enters this stage"},"assignDepartment":{"anyOf":[{"$ref":"#/properties/pipelineId"},{"type":"null"}],"description":"Department to assign when a deal enters this stage"},"addLabels":{"type":"array","items":{"type":"string","minLength":1,"maxLength":40},"maxItems":10,"description":"Labels to add when a deal enters this stage"},"removeLabels":{"type":"array","items":{"type":"string","minLength":1,"maxLength":40},"maxItems":10,"description":"Labels to remove when a deal enters this stage"}},"additionalProperties":false,"description":"Automatic actions fired when a deal enters this stage"}},"required":["name"],"additionalProperties":false},"minItems":3,"maxItems":20,"description":"Pipeline stages, in order. At least one open, one won and one lost stage are required, and the won and lost stages must come after all the open ones"},"lostReasons":{"type":"array","items":{"type":"string","minLength":1,"maxLength":60},"maxItems":20,"description":"Preset lost reasons offered when a deal is lost"},"settings":{"type":"object","properties":{"closeChatOnWon":{"type":"boolean","description":"Resolve the chat when the deal is won"},"closeChatOnLost":{"type":"boolean","description":"Resolve the chat when the deal is lost"},"ai":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable AI analysis for deals in this pipeline"},"coolOffMinutes":{"type":"integer","minimum":5,"maximum":1440,"description":"Minutes without new messages before a conversation is analyzed"}},"additionalProperties":false,"description":"AI analysis settings"}},"additionalProperties":false,"description":"Pipeline behaviour settings"},"confirmDeletion":{"type":"boolean","description":"Confirm pipeline deletion (required for delete action)"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_queue","description":"Comprehensive WhatsApp queue management tool supporting all queue operations. Perfect for monitoring queue health, controlling message delivery flow, and performing bulk message operations. Supports all WhatsApp queue operations through a unified action-based interface.\n\nAvailable actions:\n- get_status: Get comprehensive queue statistics and status information\n- update_status: Update queue processing status (pause/active/reject/freeze) with optional force delivery\n- delete_messages: Delete queued messages with flexible filtering options. A call with no messageIds, phoneNumbers, groupIds or dateRange would delete every queued and scheduled message, so it is refused unless confirmEmptyQueue is true","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"action":{"type":"string","enum":["get_status","update_status","delete_messages"],"description":"Action to perform on WhatsApp queue"},"status":{"type":"string","enum":["pause","active","reject","freeze"],"description":"Queue processing status (required for update_status action)"},"force":{"type":"boolean","default":false,"description":"Force delivery of all queued messages with no delay for 30 minutes (only works with \"active\" or \"reject\" status)"},"filters":{"type":"object","properties":{"skipScheduled":{"type":"boolean","default":false,"description":"Skip deletion of scheduled messages that will be delivered in the future"},"messageIds":{"type":"array","items":{"type":"string","minLength":18,"maxLength":32,"pattern":"^[0-9A-Fa-f]+$","description":"WhatsApp message ID (hexadecimal string)"},"minItems":1,"maxItems":500,"description":"Delete specific messages by their IDs (max 500)"},"phoneNumbers":{"type":"array","items":{"type":"string","minLength":8,"maxLength":17,"pattern":"^\\+?[1-9]\\d{1,14}$","description":"Phone number in E.164 format (e.g., +1234567890)"},"minItems":1,"maxItems":500,"description":"Delete messages targeting specific phone numbers (max 500)"},"groupIds":{"type":"array","items":{"type":"string","minLength":8,"maxLength":50,"description":"WhatsApp group/broadcast ID (e.g., 1234567890-000000000@g.us)"},"minItems":1,"maxItems":500,"description":"Delete messages targeting specific group/broadcast IDs (max 500)"},"dateRange":{"type":"object","properties":{"after":{"type":"string","maxLength":30,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}","description":"Delete messages created after this date"},"before":{"$ref":"#/properties/filters/properties/dateRange/properties/after","description":"Delete messages created before this date"}},"additionalProperties":false,"description":"Delete messages within a specific date range"}},"additionalProperties":false,"description":"Filtering options for selective message deletion (for delete_messages action)"},"waitForCompletion":{"type":"boolean","default":false,"description":"Wait until all messages are deleted (may take up to 90 seconds for large queues)"},"confirmEmptyQueue":{"type":"boolean","default":false,"description":"Set to true only to delete every queued and scheduled message of the number (scheduled ones are kept if filters.skipScheduled is true). delete_messages refuses a call without messageIds, phoneNumbers, groupIds or a dateRange unless this is true"}},"required":["device","action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_status","description":"Comprehensive WhatsApp status management tool supporting all status operations. Perfect for managing status lifecycle, publishing immediate or scheduled content, and retrieving status history. Supports all WhatsApp status operations through a unified action-based interface.\n\nAvailable actions:\n- get: Search and retrieve status history with comprehensive filtering\n- publish: Publish immediate status updates with text, images, or videos\n- schedule: Schedule status updates for future publishing with advanced timing","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["get","publish","schedule"],"description":"Action to perform on WhatsApp status"},"device":{"type":"string","minLength":24,"maxLength":24,"description":"WhatsApp device ID (24-character hex string)"},"flow":{"type":"string","enum":["inbound","outbound"],"description":"Filter by message direction (for get action)"},"mine":{"type":"boolean","description":"Return only status published by your own WhatsApp number (for get action)"},"scheduled":{"type":"boolean","description":"Return only scheduled status to be published in the future (for get action)"},"search":{"type":"string","description":"Search status by text content, contact name, or media filename (for get action)"},"chat":{"type":"string","description":"Filter status by specific chat WhatsApp ID (for get action)"},"phone":{"type":"string","minLength":10,"maxLength":15,"description":"Filter status from specific phone number or WhatsApp ID (for get action)"},"reference":{"type":"string","maxLength":150,"description":"Filter by custom reference field or set reference for publish/schedule"},"type":{"type":"array","items":{"type":"string","enum":["text","image","video"],"description":"Type of status content"},"description":"Filter by status content types (for get action)"},"ack":{"type":"array","items":{"type":"string","enum":["pending","sent","delivered","read","failed"],"description":"Message delivery status"},"description":"Filter by delivery status (for get action)"},"wid":{"type":"array","items":{"type":"string"},"description":"Filter by specific WhatsApp message IDs (for get action)"},"fromDate":{"type":"string","format":"date-time","description":"Get status published from this date onwards (for get action)"},"toDate":{"$ref":"#/properties/fromDate","description":"Get status published up to this date (for get action)"},"sortOrder":{"type":"string","enum":["asc","desc"],"description":"Sort order by creation date (for get action)"},"limit":{"type":"number","minimum":1,"maximum":100,"default":20,"description":"Maximum number of status entries to retrieve (for get action)"},"page":{"type":"number","minimum":0,"default":0,"description":"Page number for pagination (for get action)"},"message":{"type":"string","maxLength":650,"description":"Text content for status update (required for text status in publish/schedule actions)"},"media":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"URL of media file to upload"},"file":{"type":"string","description":"Previously uploaded file ID"},"message":{"type":"string","maxLength":650,"description":"Caption for media file"},"filename":{"type":"string","description":"Custom filename for media file"},"format":{"type":"string","enum":["native","gif","ptt"],"description":"Media format type"}},"additionalProperties":false,"description":"Media content (image/video) for status update (for publish/schedule actions)"},"font":{"type":"string","enum":["helvetica","serif","norican"],"description":"Font style for text status (for publish/schedule actions)"},"color":{"type":"string","enum":["red_purple","moss_green","dark_khaki","wine_red","light_taupe","goldenrod","olive_green","light_plum","dark_purple","light_coral","medium_sea_green","salmon","sky_blue","light_sky_blue","dark_taupe","slate_gray","dodger_blue","dark_magenta","seafoam_green","charcoal","periwinkle"],"description":"Background color for text status (for publish/schedule actions)"},"schedule":{"type":"object","properties":{"date":{"$ref":"#/properties/fromDate","description":"Specific date and time to publish"},"delay":{"type":"number","minimum":60,"maximum":2592000,"description":"Delay in seconds (1 minute to 30 days)"},"delayTo":{"type":"string","enum":["15m","30m","1h","2h","6h","12h","1d","2d","3d","1w"],"description":"Delay using time notation"}},"additionalProperties":false,"description":"Schedule options for delayed publishing (for publish action)"},"order":{"type":"boolean","default":false,"description":"Enforce strict publication order for scheduled status (for publish action)"},"idempotencyKey":{"type":"string","description":"Unique key to prevent duplicate status publishing (for publish action)"},"scheduleType":{"type":"string","enum":["delay","delayTo","date"],"description":"Type of scheduling method (required for schedule action)"},"delay":{"type":"number","minimum":60,"maximum":2592000,"description":"Delay in seconds (for schedule action with scheduleType: delay)"},"delayTo":{"type":"string","enum":["15m","30m","1h","2h","6h","12h","1d","2d","3d","1w"],"description":"Time notation delay (for schedule action with scheduleType: delayTo)"},"publishDate":{"$ref":"#/properties/fromDate","description":"Specific publish date and time (for schedule action with scheduleType: date)"},"strictOrder":{"type":"boolean","default":false,"description":"Enforce strict publication order (for schedule action)"},"timezone":{"type":"string","description":"Timezone for date scheduling (for schedule action)"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_team","description":"Comprehensive WhatsApp team management tool supporting all team operations. Perfect for managing team member lifecycle, device access, and role assignments. Supports all WhatsApp team operations through a unified action-based interface.\n\nAvailable actions:\n- search: Search and list team members with filtering options\n- get: Get detailed information about a specific team member by ID\n- create: Create a new team member and grant them access to a WhatsApp device (requires device, email, displayName, password, role and color)\n- update: Update an existing team member's name, email, password, role or color\n- delete: Delete one or more team members from the account, choosing what happens to their assigned chats\n- grant_access: Grant an existing team member access to a WhatsApp device\n- revoke_access: Revoke a team member's access to a WhatsApp device, choosing what happens to their assigned chats\n\nNotes:\n- New team members are always created against a specific WhatsApp device and are granted access to it immediately.\n- grant_access and revoke_access operate on a single team member at a time.\n- delete, and revoke_access when chatAction is \"reassign\", require reassignTo.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["search","get","create","update","delete","grant_access","revoke_access"],"description":"Action to perform on WhatsApp team members"},"userId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Team member ID (required for get, update, grant_access and revoke_access actions)"},"userIds":{"type":"array","items":{"$ref":"#/properties/userId"},"minItems":1,"maxItems":10,"description":"Array of team member IDs to delete (required for the delete action, max 10)"},"email":{"type":"string","format":"email","minLength":5,"maxLength":100,"description":"Team member email address (required for create; may be used instead of userId to identify the member for delete and revoke_access)"},"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID (required for create, grant_access and revoke_access actions; optional filter for search)"},"query":{"type":"string","minLength":2,"maxLength":100,"description":"Free text search over team member name and email (for search action)"},"role":{"type":"string","enum":["admin","supervisor","agent"],"description":"Filter by team member role for search, or the role to assign for create and update"},"status":{"type":"string","enum":["any","active","inactive","pending","removed"],"description":"Filter by team member status (for search action)"},"ids":{"type":"array","items":{"$ref":"#/properties/userId"},"maxItems":30,"description":"Restrict search results to these team member IDs"},"exceptIds":{"type":"array","items":{"$ref":"#/properties/userId"},"maxItems":50,"description":"Exclude these team member IDs from search results"},"loginBefore":{"type":"string","format":"date-time","description":"Only team members whose last login is before this ISO 8601 date and time"},"loginAfter":{"$ref":"#/properties/loginBefore","description":"Only team members whose last login is after this ISO 8601 date and time"},"onlineBefore":{"$ref":"#/properties/loginBefore","description":"Only team members last seen online before this ISO 8601 date and time"},"onlineAfter":{"$ref":"#/properties/loginBefore","description":"Only team members last seen online after this ISO 8601 date and time"},"page":{"type":"integer","minimum":0,"maximum":100,"default":0,"description":"Results page number"},"size":{"type":"integer","minimum":1,"maximum":300,"default":50,"description":"Maximum number of results per page"},"displayName":{"type":"string","minLength":2,"maxLength":30,"description":"Team member display name (required for create)"},"password":{"type":"string","minLength":5,"maxLength":50,"description":"Team member password (required for create, optional for update)"},"color":{"type":"string","enum":["blue","azure","indigo","purple","pink","red","orange","yellow","lime","green","teal","cyan","gray","gray-dark"],"description":"Team member color (required for create, optional for update)"},"invite":{"type":"boolean","default":false,"description":"Send an invitation email to the new team member (for create action)"},"chatAction":{"type":"string","enum":["unassign","reassign","resolve"],"description":"What to do with the chats assigned to the removed team member","default":"unassign"},"reassignTo":{"$ref":"#/properties/userId","description":"Team member ID to reassign chats to (required when chatAction is \"reassign\")"},"force":{"type":"boolean","default":false,"description":"Delete team members even when they still have access to active WhatsApp devices (for delete action)"},"remove":{"type":"boolean","default":false,"description":"Also delete the team member from the account, not just from this device (for revoke_access action)"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"manage_whatsapp_web_form_appearance","description":"How the web forms of one WhatsApp number look: business name, description, accent colour, footer, privacy, terms and website links, and the logo. Actions: get, update, set_logo (an https URL or a base64 PNG/JPEG up to 1 MB), remove_logo. Changes reach open forms within about a minute.\n\nOn WhatsApp Cloud API numbers, a form goes out as a template outside the 24-hour window, and campaigns there only send templates: link_templates lists the number's templates whose URL button opens a form link (with that button's index), and create_link_template creates one (UTILITY, one URL button) and submits it to WhatsApp for review. Then send it with send_whatsapp_web_form and its template argument. For WhatsApp Forms (Meta WhatsApp Flows, native in-chat forms on WhatsApp Business API numbers) use send_whatsapp_flow and list_whatsapp_flows instead.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["get","update","set_logo","remove_logo","link_templates","create_link_template"],"description":"What to do"},"device":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp number (device) ID, 24 hex characters. Use get_whatsapp_devices to find it"},"name":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"description":"Business name shown on the forms; null or \"\" goes back to the WhatsApp profile default"},"description":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"description":"One paragraph under the name; null or \"\" goes back to the WhatsApp profile default"},"color":{"anyOf":[{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},{"type":"null"}],"description":"Accent colour, #RRGGBB; null goes back to the default"},"footer":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Plain text at the foot of every form; null or \"\" goes back to the WhatsApp profile default"},"links":{"type":"object","properties":{"privacy":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^https:\\/\\/"},{"type":"null"}]},"terms":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^https:\\/\\/"},{"type":"null"}]},"website":{"anyOf":[{"type":"string","maxLength":512,"pattern":"^https:\\/\\/"},{"type":"null"}]}},"additionalProperties":false,"description":"Legal and website links, https; null removes one"},"logoHidden":{"type":"boolean","description":"Hide the logo without removing it"},"url":{"type":"string","format":"uri","pattern":"^https:\\/\\/","description":"set_logo: https URL of a PNG or JPEG"},"image":{"type":"string","minLength":16,"maxLength":1500000,"description":"set_logo: the image as base64 or a data URI"},"language":{"type":"string","minLength":2,"maxLength":6,"description":"create_link_template: WhatsApp template language code, e.g. en_US, es, pt_BR"},"templateName":{"type":"string","maxLength":512,"pattern":"^[a-z0-9_]+$","description":"create_link_template: template name; web_form_link by default"},"text":{"type":"string","maxLength":1024,"description":"create_link_template: text above the button, without variables; a default one in the template language when left out"},"buttonText":{"type":"string","maxLength":25,"description":"create_link_template: button text, up to 25 characters"}},"required":["action","device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"manage_whatsapp_web_form_links","description":"Manage web form links: one link per chat, bound to the published version of a form. Actions: create (a link without sending it: the token and url are returned once), list (the links of a form, by state: created, sent, opened, started, submitted, expired, revoked), get, revoke, renew (move the expiry forward from now), chat (the web forms sent in one chat, with their answers). revoke answers a preview and a confirmToken first. To send a form as a message, use send_whatsapp_web_form. For WhatsApp Forms (Meta WhatsApp Flows, native in-chat forms on WhatsApp Business API numbers) use send_whatsapp_flow and list_whatsapp_flows instead.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["create","list","get","revoke","renew","chat"],"description":"What to do"},"formId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"create, list: the web form"},"linkId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"get, revoke, renew: the link"},"device":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"create: number the link is for (needed with several numbers); list: only this number; chat: the number of the chat"},"chat":{"type":"string","minLength":6,"maxLength":120,"description":"create: the chat the link is for; list: only this chat; chat: the chat to read"},"phone":{"type":"string","minLength":6,"maxLength":20,"description":"create: the phone number the link is for; list: only this phone"},"contact":{"type":"string","minLength":6,"maxLength":120,"description":"create: the contact (chat ID or phone) the link is for"},"expiresIn":{"anyOf":[{"type":"string","pattern":"^\\d{1,4}[hd]$"},{"type":"integer","minimum":3600,"maximum":7776000}],"description":"How long the link works: \"48h\", \"7d\", or seconds (1 hour to 90 days). The form's own setting when omitted"},"variables":{"type":"object","additionalProperties":{"type":["string","number","boolean","null"]},"description":"Flat values the form reads as link.<key> (keys a-z, 0-9 and _, at most 2 KB in all), e.g. { \"order_id\": \"A-1029\" }"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https:\\/\\/","description":"https URL that receives the submission as well as the webhooks"},"reference":{"type":"string","minLength":1,"maxLength":100,"description":"Your own reference for this link, kept with it and its submissions"},"idempotencyKey":{"type":"string","minLength":6,"maxLength":36,"pattern":"^[A-Za-z0-9_.:-]+$","description":"Your unique key for this request, 6 to 36 characters (a UUID works). Reuse it when retrying: the API answers the form or link already created instead of a second one"},"status":{"type":"array","items":{"type":"string","enum":["created","sent","opened","started","submitted","expired","revoked"]},"minItems":1,"description":"list: only links in these states"},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"list: created from this day, YYYY-MM-DD (UTC)"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"list: created until this day, YYYY-MM-DD (UTC)"},"page":{"type":"integer","minimum":0,"description":"Page, from 0"},"size":{"type":"integer","minimum":1,"maximum":100,"description":"Rows per page (default 25, max 100)"},"confirmToken":{"type":"string","minLength":8,"maxLength":64,"description":"Token from the preview, sent back once the user approved the change"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"manage_whatsapp_web_form_submissions","description":"Read what customers answered in web forms, newest first. Actions: list (filters: form, number, chat, contact, phone, agent, source, dates), get (one submission with every answer), export (csv or json, up to 10,000 rows; when the result is too large to show, it answers the count so you can narrow the range). Answers are personal data: show only what the user asked for. Answers marked sensitive are left out. For WhatsApp Forms (Meta WhatsApp Flows, native in-chat forms on WhatsApp Business API numbers) use send_whatsapp_flow and list_whatsapp_flows instead. (their answers: list_whatsapp_flow_responses)","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","get","export"],"description":"What to do"},"submissionId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"get: the submission"},"formId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"Only submissions of this web form"},"forms":{"type":"array","items":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$"},"minItems":1,"maxItems":29,"description":"More web forms to include"},"device":{"type":"array","items":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$"},"minItems":1,"maxItems":10,"description":"Only these numbers"},"chat":{"type":"string","minLength":6,"maxLength":120,"description":"Only this chat"},"contact":{"type":"string","minLength":6,"maxLength":120,"description":"Only this contact (chat ID or phone)"},"phone":{"type":"string","minLength":6,"maxLength":20,"description":"Only this phone number"},"agent":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"Only links sent by this team member"},"source":{"type":"array","items":{"type":"string","enum":["agent","api","flow","campaign","autoreply","mcp","public"]},"minItems":1,"description":"Only links created this way"},"status":{"type":"string","enum":["complete","pending_binding"]},"pipeline":{"type":"string","enum":["pending","failed"],"description":"Only submissions whose CRM write-back is pending or failed"},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Submitted from this day, YYYY-MM-DD (UTC)"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Submitted until this day, YYYY-MM-DD (UTC)"},"ids":{"type":"array","items":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$"},"minItems":1,"maxItems":100,"description":"export: only these submissions"},"format":{"type":"string","enum":["json","csv"],"description":"export: json (default) or csv"},"page":{"type":"integer","minimum":0,"description":"Page, from 0"},"size":{"type":"integer","minimum":1,"maximum":100,"description":"Rows per page (default 25, max 100)"},"verbosity":{"type":"string","enum":["summary","standard","full"],"description":"summary (default): the fields needed most; standard: more context; full: everything the API returns"},"fields":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":50,"description":"Return only these dot-paths, e.g. [\"id\", \"name\", \"status\"]. Overrides verbosity"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"manage_whatsapp_web_forms","description":"Build and manage web forms: forms customers fill in the browser from a short link sent in a WhatsApp chat, with the answers coming back as structured submissions. For WhatsApp Forms (Meta WhatsApp Flows, native in-chat forms on WhatsApp Business API numbers) use send_whatsapp_flow and list_whatsapp_flows instead.\n\nActions: list, get, create (blank, from a template, or from a definition), update (name, settings, numbers, or the whole draft), edit (operations on the draft, as { type: \"addBlock\", step, blockType, label, ... }), publish, archive, restore, duplicate, delete, versions, version (one published version with its answers JSON Schema), templates (the gallery), metrics, set_og_image (your own link preview image: an https URL or a base64 PNG/JPEG up to 1 MB, cropped to 1200×630), remove_og_image (back to the automatic one), set_public (a standing public link anyone can open, waform.app/m/..., bound to one number: for ads, bio links and QR codes), unset_public (turn it off).\n\nEdits change the draft only: a published form keeps serving its live version until the next publish. publish, archive, delete and an edit with confirm=true answer a preview and a confirmToken first: show the preview to the user and call again with the token once they approve. To send a form, use send_whatsapp_web_form.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","get","create","update","edit","publish","archive","restore","duplicate","delete","versions","version","templates","metrics","set_og_image","remove_og_image","set_public","unset_public"],"description":"What to do"},"formId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"Web form ID (id from the list action)"},"status":{"type":"array","items":{"type":"string","enum":["draft","published","archived"]},"minItems":1,"description":"list: only forms in these states"},"search":{"type":"string","minLength":1,"maxLength":100,"description":"list: text in the form name"},"device":{"type":"array","items":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$"},"minItems":1,"maxItems":10,"description":"list: forms these numbers may send. metrics: only these numbers"},"sort":{"type":"string","enum":["date:desc","date:asc","name"],"description":"list: order (newest first by default)"},"page":{"type":"integer","minimum":0,"description":"Page, from 0"},"size":{"type":"integer","minimum":1,"maximum":100,"description":"Rows per page (default 25, max 100)"},"verbosity":{"type":"string","enum":["summary","standard","full"],"description":"summary (default): the fields needed most; standard: more context; full: everything the API returns"},"fields":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":50,"description":"Return only these dot-paths, e.g. [\"id\", \"name\", \"status\"]. Overrides verbosity"},"name":{"type":"string","minLength":1,"maxLength":120,"description":"create, update, duplicate: form name"},"description":{"type":"string","maxLength":500,"description":"create, update: internal description"},"language":{"type":"string","minLength":2,"maxLength":12,"description":"create, update: form language, e.g. en, es"},"definition":{"type":"object","additionalProperties":{},"description":"create, update: a whole form definition (format 1). Prefer template on create and edit afterwards"},"template":{"type":"string","minLength":1,"maxLength":60,"description":"create: template id from the templates action"},"settings":{"type":"object","additionalProperties":{},"description":"create, update: settings such as { link: { ttlHours, afterSubmit }, submit: { successTitle, successText }, crm: { mappings, contactLabels, timelineCard } }"},"devices":{"type":"array","items":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$"},"maxItems":50,"description":"create, update: numbers allowed to send the form (all when empty)"},"idempotencyKey":{"type":"string","minLength":6,"maxLength":36,"pattern":"^[A-Za-z0-9_.:-]+$","description":"create: your unique key for this form, 6 to 36 characters. Reuse it when retrying: the API answers the form already created"},"ops":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","minLength":1}},"required":["type"],"additionalProperties":true},"minItems":1,"maxItems":100,"description":"edit: draft operations, applied all or none, e.g. [{ \"type\": \"addBlock\", \"step\": \"details\", \"blockType\": \"email\", \"label\": \"Your email\", \"required\": true }]"},"confirm":{"type":"boolean","description":"edit: true to rename or remove a key a published version holds (the API refuses those edits otherwise). It answers a preview and a confirmToken first"},"version":{"type":"integer","minimum":1,"description":"version: the published version number"},"lang":{"type":"string","minLength":2,"maxLength":5,"description":"templates: language of the gallery (es, en, pt, fr, it, de)"},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"metrics: first day, YYYY-MM-DD (UTC)"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"metrics: last day, YYYY-MM-DD (UTC)"},"groupBy":{"type":"string","enum":["day","none"],"description":"metrics: daily rows, or totals only"},"url":{"type":"string","format":"uri","pattern":"^https:\\/\\/","description":"set_og_image: https URL of a PNG or JPEG"},"image":{"type":"string","minLength":16,"maxLength":1500000,"description":"set_og_image: the image as base64 or a data URI"},"slug":{"type":"string","minLength":3,"maxLength":48,"pattern":"^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){1,46}[a-z0-9]$","description":"set_public: the end of the public link, e.g. acme-booking"},"publicDevice":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"set_public: the number the public link is bound to; its appearance brands the page and it receives the leads"},"captcha":{"type":"boolean","description":"set_public: ask visitors for an invisible check when the platform has one configured (default true)"},"deleteSubmissions":{"type":"boolean","description":"delete: also delete the form's submissions, links and counters"},"confirmToken":{"type":"string","minLength":8,"maxLength":64,"description":"Token from the preview, sent back once the user approved the change"}},"required":["action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"ping","description":"Basic ping test to check MCP server connectivity and response time. Returns server status and timestamp.","inputSchema":{"type":"object","properties":{"message":{"type":"string","maxLength":100,"default":"ping","description":"Optional message to include in the ping response"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"search_whatsapp_chat_files","description":"Search and list received files from WhatsApp chats (inbound files). These are media files that were sent to your WhatsApp number by other users. Supports filtering by chat, file type, date range, and more.","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"search":{"type":"string","minLength":1,"maxLength":200,"description":"Search files by filename or content"},"type":{"type":"array","items":{"type":"string","enum":["image","video","audio","document","ptt","sticker"]},"description":"Filter by file media types"},"chat":{"type":"array","items":{"type":"string"},"description":"Filter by specific chat IDs"},"flow":{"type":"string","enum":["in","out","inbound","outbound"],"description":"Filter by message flow direction"},"after":{"type":"string","format":"date-time","description":"Filter files received after this date (ISO 8601 format)"},"before":{"type":"string","format":"date-time","description":"Filter files received before this date (ISO 8601 format)"},"page":{"type":"integer","minimum":0,"maximum":100,"default":0,"description":"Page number for pagination (0-based)"},"size":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Number of files to return per page"},"sort":{"type":"string","enum":["date:desc","date:asc","size:desc","size:asc"],"default":"date:desc","description":"Sort order for results"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"search_whatsapp_chats_by_name","description":"Search for WhatsApp chats by contact name, group name, phone number, company, metadata or private notes. Perfect for quickly finding specific conversations.\n\nSame as get_whatsapp_chats with action \"search\".","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"WhatsApp device ID connected to Wassenger (24 character hexadecimal string)"},"query":{"type":"string","minLength":1,"maxLength":150,"description":"Free text to search for (required for search action)"},"contactTypes":{"type":"array","items":{"type":"string","enum":["chat","group","community","channel","broadcast"],"description":"Type of WhatsApp chat"},"maxItems":5,"description":"Filter by chat type (required for by_contact_type action, optional elsewhere)"},"limit":{"type":"number","minimum":1,"maximum":100,"default":20,"description":"Number of WhatsApp chats per call (max 100)"},"page":{"type":"number","minimum":0,"maximum":300,"default":0,"description":"Results page, starting at 0"}},"required":["device"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"search_whatsapp_outbound_files","description":"Search and list uploaded WhatsApp files with advanced filtering. Returns outbound files that have been uploaded to the platform for sending as media messages. Supports extensive filtering by filename, file type, size, creation date, tags, and more.","inputSchema":{"type":"object","properties":{"search":{"type":"string","minLength":1,"maxLength":200,"description":"Search files by filename, tags, or reference ID"},"filename":{"type":"string","maxLength":200,"description":"Filter by exact filename"},"format":{"type":"array","items":{"type":"string","enum":["gif","ptt","native"]},"description":"Filter by file format types"},"mime":{"type":"array","items":{"type":"string"},"description":"Filter by MIME types (e.g., [\"image/jpeg\", \"video/mp4\"])"},"kind":{"type":"array","items":{"type":"string"},"description":"Filter by file kinds (e.g., [\"image\", \"video\", \"document\"])"},"ext":{"type":"array","items":{"type":"string"},"description":"Filter by file extensions (e.g., [\"jpg\", \"pdf\", \"mp4\"])"},"tags":{"type":"array","items":{"type":"string"},"description":"Filter by file tags"},"status":{"type":"array","items":{"type":"string","enum":["pending","active","ready","error","expired"]},"description":"Filter by file status"},"permission":{"type":"string","enum":["public","readonly","private"],"description":"Filter by access permission level"},"origin":{"type":"string","enum":["upload","remote"],"description":"Filter by upload origin: upload (local file) or remote (URL)"},"after":{"type":"string","format":"date-time","description":"Filter files created after this date (ISO 8601 format)"},"before":{"type":"string","format":"date-time","description":"Filter files created before this date (ISO 8601 format)"},"minSize":{"type":"integer","minimum":1,"description":"Minimum file size in bytes"},"maxSize":{"type":"integer","minimum":1,"description":"Maximum file size in bytes"},"page":{"type":"integer","minimum":0,"maximum":100,"default":0,"description":"Page number for pagination (0-based)"},"size":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Number of files to return per page"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"send_whatsapp_flow","description":"Send a published WhatsApp Form (Meta WhatsApp Flow) to a chat as a native interactive message: one message instead of asking question after question. Only works within the 24h customer-service window; to start a conversation, send a template whose button opens the form. Pass a token to match the answers to your own record (it comes back in the message:flow:response webhook), and data to prefill the form.","inputSchema":{"type":"object","properties":{"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Target WhatsApp device ID (24 character hex string)"},"phone":{"type":"string","minLength":6,"description":"Recipient phone number in international format (E.164), e.g. +34600111222"},"flow_id":{"type":"string","description":"The WhatsApp Flow ID to send (flowId from list_whatsapp_flows)"},"cta":{"type":"string","minLength":1,"maxLength":30,"description":"Text of the button that opens the form (max 30 chars)"},"body":{"type":"string","minLength":1,"maxLength":1024,"description":"Message text shown above the button (max 1024 chars)"},"screen":{"type":"string","description":"Screen to open. If omitted, the form opens on its first screen."},"token":{"type":"string","minLength":1,"maxLength":200,"description":"Your reference for this send (an order or ticket id). It comes back with the answers."},"data":{"type":"object","additionalProperties":{},"description":"Values to prefill the form with, by field name"},"header":{"type":"string","minLength":1,"maxLength":60,"description":"Header text above the message (max 60 chars)"},"footer":{"type":"string","minLength":1,"maxLength":60,"description":"Footer text under the message (max 60 chars)"},"idempotencyKey":{"type":"string","minLength":6,"maxLength":36,"description":"Your unique key for this message, 6 to 36 characters (a UUID works). Reuse the same key when retrying the same message: the API then answers 409 Conflict with the id of the message already created instead of sending it twice. Use a new key for every different message."}},"required":["device","phone","flow_id","cta"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"openWorldHint":true}},{"name":"send_whatsapp_message","description":"Comprehensive WhatsApp message sending with action-based operations. Supports all message types including text, media, location, contact, poll, event messages, with scheduling, live delivery, expiration, agent messaging, and template support. All message sending operations unified in one tool.\n\nScheduling: pass exactly one of deliverAt, delay or delayTo on the text, media, template, agent or scheduled actions. Leaving all three out sends the message right away. On WhatsApp Cloud API (WABA) numbers a plain text, media or agent message still needs the customer to have written within the last 24 hours at delivery time, so a reminder that lands later than that must use the template action.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["text","template","scheduled","media","location","contact","poll","event","live","expiring","agent"],"description":"Action to perform for WhatsApp message sending"},"chat":{"type":"string","minLength":6,"maxLength":40,"description":"WhatsApp chat ID (e.g., 1234567890@c.us for phone numbers, 123456789000000000@g.us for groups, 123456789000000@newsletter for WhatsApp channels)"},"device":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Target WhatsApp device ID (24 character hex string) used for message delivery. Only required if you have multiple WhatsApp numbers connected. Use MCP tool \"get_whatsapp_devices\" to retrieve a list of available devices."},"message":{"type":"string","minLength":1,"maxLength":15000,"description":"Text message content (required for text, scheduled, live, expiring, agent, template actions)"},"previewUrl":{"type":"boolean","default":true,"description":"Enable URL preview in messages (for text, template actions)"},"deliverAt":{"type":"string","description":"Absolute ISO 8601 instant to deliver the message at, with a time zone (e.g. 2026-09-20T09:00:00+02:00). Must be in the future and less than a year away"},"delay":{"type":"integer","minimum":1,"description":"Deliver the message after this many seconds (max 31536000, a year)"},"delayTo":{"type":"string","description":"Deliver the message after a duration: 30m, 2h, 3d, 2w, 1M (max a year)"},"media":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Public URL of the media file"},"file":{"type":"string","description":"Uploaded file ID from Wassenger"},"format":{"type":"string","enum":["gif","ptt","native"],"description":"Media format (gif for GIFs, ptt for voice notes)"},"viewOnce":{"type":"boolean","description":"Send as view-once media"},"filename":{"type":"string","description":"Custom filename for the media"}},"additionalProperties":false,"description":"Media content (required for media action)"},"location":{"type":"object","properties":{"address":{"type":"string","description":"Human-readable address"},"coordinates":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2,"description":"Latitude and longitude coordinates"},"name":{"type":"string","description":"Location name or title"}},"additionalProperties":false,"description":"Location content (required for location action)"},"contacts":{"type":"array","items":{"type":"object","properties":{"phone":{"type":"string","minLength":8,"maxLength":16,"description":"Phone number in E.164 format (e.g., +1234567890)"},"name":{"type":"string","minLength":1,"description":"Contact name"},"email":{"type":"string","format":"email","description":"Contact email"},"organization":{"type":"string","description":"Contact organization"},"url":{"type":"string","format":"uri","description":"Contact website URL"}},"additionalProperties":false},"minItems":1,"maxItems":10,"description":"Array of contacts to send, max 10 (required for contact action)"},"poll":{"type":"object","properties":{"question":{"type":"string","minLength":1,"maxLength":100,"description":"Poll question"},"options":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"minItems":2,"maxItems":12,"description":"Poll voting options (2-12 options)"},"multipleAnswers":{"type":"boolean","default":false,"description":"Allow multiple answer selection"},"secret":{"type":"boolean","default":false,"description":"Hide vote results until poll ends"}},"additionalProperties":false,"description":"Poll content (required for poll action)"},"event":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"Event name"},"description":{"type":"string","maxLength":500,"description":"Event description"},"date":{"type":"string","description":"Event date in ISO 8601 format"},"location":{"type":"string","maxLength":200,"description":"Event location"},"callType":{"type":"string","enum":["voice","video"],"description":"Type of call event"},"callLink":{"type":"string","format":"uri","description":"Call link for the event"}},"additionalProperties":false,"description":"Event content (required for event action)"},"enqueue":{"type":"string","enum":["never","opportunistic"],"default":"never","description":"Message delivery mode (for live action)"},"expiration":{"type":"string","description":"Time-to-live duration e.g. \"1h\", \"30m\", \"2d\" (for expiring action)"},"agentId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"Agent ID for agent messaging (required for agent action)"},"actions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string","enum":["chat:assign","chat:unassign","chat:resolve","chat:unresolve","chat:read","chat:unread","labels:add","labels:remove","labels:set","metadata:set","metadata:add","metadata:remove"]},"params":{"type":"object","additionalProperties":{}}},"required":["action"],"additionalProperties":false},"maxItems":10,"description":"Actions to perform after message delivery (for agent action)"},"template":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Approved template name"},"language":{"type":"string","pattern":"^[a-z]{2}(_[A-Z]{2})?$","description":"Template language code (e.g., en, en_US)"},"header":{"type":"object","properties":{"text":{"type":"object","properties":{"name":{"type":"string","maxLength":32,"description":"Variable placeholder name (e.g., \"0\", \"1\", \"name\")"},"value":{"type":"string","maxLength":1024,"description":"Text value to replace the placeholder"}},"additionalProperties":false},"media":{"type":"object","properties":{"type":{"type":"string","enum":["image","video","document"]},"file":{"type":"string","minLength":24,"maxLength":24,"description":"Uploaded file ID (24 char hex)"},"url":{"type":"string","format":"uri","description":"Public URL of the media"},"caption":{"type":"string","maxLength":1024},"filename":{"type":"string"}},"additionalProperties":false},"location":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"name":{"type":"string"},"address":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false,"description":"Template header variables"},"body":{"type":"array","items":{"anyOf":[{"$ref":"#/properties/template/properties/header/properties/text"},{"type":"object","properties":{"currency":{"type":"string","minLength":3,"maxLength":3,"description":"ISO 4217 Currency Code (e.g. USD, EUR)"},"amount":{"type":"integer","description":"Amount in minor units multiplied by 1000 (e.g. 10990 for $10.99)"},"presentation":{"type":"string","description":"Default text if localization fails (e.g. \"$10.99\")"}},"additionalProperties":false},{"type":"object","properties":{"date":{"type":"string","description":"ISO 8601 date string"},"timestamp":{"type":"integer","description":"Unix epoch timestamp in seconds"},"timezone":{"type":"string","description":"IAN time zone name"},"calendar":{"type":"string","enum":["gregorian","solar_hijri"]}},"additionalProperties":false}]},"maxItems":15,"description":"Template body variables"},"button":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["quick_reply","url","copy_code","mpm","flow"]},"position":{"type":"integer","minimum":0,"maximum":9,"description":"Button position index (0-9)"},"url":{"type":"string","description":"URL suffix for URL buttons"},"name":{"type":"string","description":"Variable name for URL buttons"},"value":{"type":"string","description":"Variable value for URL buttons"},"coupon":{"type":"string","description":"Coupon code for copy_code buttons"},"payload":{"type":"string","description":"Payload for quick_reply buttons"},"action":{"type":"object","properties":{"flow":{"type":"string"},"data":{"type":"object","additionalProperties":{}},"thumbnail":{"type":"string"},"sections":{"type":"array"}},"additionalProperties":false}},"additionalProperties":false},"maxItems":10,"description":"Template button variables"},"timeoffer":{"type":"object","properties":{"date":{"type":"string"},"timestamp":{"type":"integer"},"timezone":{"type":"string"}},"additionalProperties":false,"description":"Limited time offer expiration"},"flow":{"type":"object","properties":{"token":{"type":"string","minLength":1,"maxLength":200,"description":"Your reference for this send; it comes back with the answers"},"data":{"type":"object","additionalProperties":{},"description":"Values to prefill the form with, by field name"}},"additionalProperties":false,"description":"For a template whose button opens a WhatsApp Form"}},"additionalProperties":false,"description":"Template configuration (required for template action)"},"order":{"type":"boolean","default":false,"description":"Ensure strict message delivery order"},"agent":{"$ref":"#/properties/agentId","description":"Agent ID (24 character hex string)"},"reference":{"type":"string","minLength":1,"maxLength":150,"description":"Custom reference ID for message tracking"},"sendReadAck":{"type":"boolean","default":true,"description":"Send chat read acknowledgment after the message is delivered"},"idempotencyKey":{"type":"string","minLength":6,"maxLength":36,"description":"Your unique key for this message, 6 to 36 characters (a UUID works). Reuse the same key when retrying the same message: the API then answers 409 Conflict with the id of the message already created instead of sending it twice. Use a new key for every different message."}},"required":["action","chat"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"send_whatsapp_web_form","description":"Send a published web form to a WhatsApp chat as a message with a short link. The link is minted for that chat only and is put where the message says {{form.url}}, or added at the end. The customer's answers arrive as a submission (see manage_whatsapp_web_form_submissions) and in the form:submitted webhook. For WhatsApp Forms (Meta WhatsApp Flows, native in-chat forms on WhatsApp Business API numbers) use send_whatsapp_flow and list_whatsapp_flows instead.\n\nOn WhatsApp Cloud API numbers a free-text message needs the customer to have written within the last 24 hours. Outside that window pass template: an approved template whose URL button opens a form link (list or create one with manage_whatsapp_web_form_appearance, actions link_templates and create_link_template). Pass an idempotencyKey: a retry with the same key is refused instead of sending the form twice.","inputSchema":{"type":"object","properties":{"formId":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"Web form ID (id from the list action)"},"device":{"type":"string","pattern":"^[0-9A-Fa-f]{24}$","description":"Number to send from. Needed when the account has more than one"},"chat":{"type":"string","minLength":6,"maxLength":120,"description":"Chat ID, e.g. 34600111222@c.us (individual chats only: groups and channels cannot receive web forms)"},"phone":{"type":"string","minLength":6,"maxLength":20,"description":"Phone number in international format (E.164), e.g. +34600111222"},"message":{"type":"string","minLength":1,"maxLength":4000,"description":"Message text; put {{form.url}} where the link goes, e.g. \"Hi Maria! Please confirm your delivery: {{form.url}}\". The link is appended when there is none"},"expiresIn":{"anyOf":[{"type":"string","pattern":"^\\d{1,4}[hd]$"},{"type":"integer","minimum":3600,"maximum":7776000}],"description":"How long the link works: \"48h\", \"7d\", or seconds (1 hour to 90 days). The form's own setting when omitted"},"variables":{"type":"object","additionalProperties":{"type":["string","number","boolean","null"]},"description":"Flat values the form reads as link.<key> (keys a-z, 0-9 and _, at most 2 KB in all), e.g. { \"order_id\": \"A-1029\" }"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https:\\/\\/","description":"https URL that receives the submission as well as the webhooks"},"reference":{"type":"string","minLength":1,"maxLength":100,"description":"Your own reference for this link, kept with it and its submissions"},"template":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[a-z0-9_]+$","description":"Approved template with a form link button, as link_templates lists it"},"language":{"type":"string","minLength":2,"maxLength":6,"description":"Template language code, e.g. es or en_US"},"button":{"type":"integer","minimum":0,"maximum":9,"default":0,"description":"Index of the form link button, as link_templates says. 0 for templates made by create_link_template"}},"required":["name","language"],"additionalProperties":false,"description":"WhatsApp Cloud API numbers, outside the 24-hour window: send the form as this template instead of a text. message is then ignored"},"idempotencyKey":{"type":"string","minLength":6,"maxLength":36,"pattern":"^[A-Za-z0-9_.:-]+$","description":"Your unique key for this message, 6 to 36 characters. Reuse it when retrying the same send: the API refuses a second message with 409 instead of sending it twice"}},"required":["formId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"update_whatsapp_file_metadata","description":"Update metadata and properties of an uploaded WhatsApp file. You can modify filename, tags, expiration time, access permissions, format, and reference ID to better organize and manage your files.","inputSchema":{"type":"object","properties":{"fileId":{"type":"string","minLength":24,"maxLength":24,"pattern":"^[0-9A-Fa-f]{24}$","description":"File ID (24 character hexadecimal string)"},"filename":{"type":"string","minLength":1,"maxLength":200,"description":"New filename for the file"},"reference":{"type":"string","minLength":2,"maxLength":150,"description":"New reference identifier"},"format":{"type":"string","enum":["gif","ptt","native"],"description":"New file presentation format"},"tags":{"type":"array","items":{"type":"string","minLength":1,"maxLength":50},"minItems":1,"maxItems":10,"description":"New tags for the file"},"message":{"type":"string","maxLength":15000,"description":"Default caption text for media messages (images/videos only)"},"expiration":{"type":"string","enum":["10m","30m","1h","6h","12h","1d","2d","3d","5d","6d","7d","15d","30d","60d","90d","120d","180d","360d","1y","2y"],"description":"New expiration time-to-live"},"permission":{"type":"string","enum":["public","readonly","private"],"description":"New access permission level"}},"required":["fileId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"upload_whatsapp_file_from_url","description":"Upload a file from a remote URL to the WhatsApp platform for use in media messages. The file will be downloaded from the provided URL and stored securely. Returns the uploaded file details including ID for use in message sending.","inputSchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","minLength":6,"maxLength":1024,"description":"Public URL from which to download file contents"},"filename":{"type":"string","minLength":1,"maxLength":200,"description":"Custom filename for the uploaded file"},"format":{"type":"string","enum":["gif","ptt","native"],"description":"File presentation format (gif for videos as GIF, ptt for audio as voice note)"},"expiration":{"type":"string","enum":["10m","30m","1h","6h","12h","1d","2d","3d","5d","6d","7d","15d","30d","60d","90d","120d","180d","360d","1y","2y"],"description":"File expiration time-to-live"},"permission":{"type":"string","enum":["public","readonly","private"],"description":"File access permission level"},"reference":{"type":"string","minLength":2,"maxLength":100,"description":"Optional reference identifier for file tracking"},"tags":{"type":"array","items":{"type":"string","minLength":1,"maxLength":50},"maxItems":10,"description":"Optional tags for file categorization"}},"required":["url"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"validatePhoneNumbers","description":"Validates the format of given phone numbers according to E.164 standard and checks their potential validity. Can validate up to 500 phone numbers at once.","inputSchema":{"type":"object","properties":{"phoneNumbers":{"type":"array","items":{"type":"string","minLength":8,"maxLength":16},"minItems":1,"maxItems":500,"description":"Array of phone numbers to validate in E.164 format (max 500)"}},"required":["phoneNumbers"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"openWorldHint":true}},{"name":"verifyWhatsAppNumberExists","description":"Checks if a given phone number is associated with an active WhatsApp account.","inputSchema":{"type":"object","properties":{"phoneNumber":{"type":"string","minLength":8,"maxLength":16,"description":"The phone number to verify in E.164 format"}},"required":["phoneNumber"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}],"prompts":[{"description":"Generate a structured prompt for sending a WhatsApp message","name":"send-whatsapp-message"},{"description":"Generate a structured prompt for sending a WhatsApp template","name":"send-whatsapp-template"},{"description":"Generate a structured prompt for verifying if a WhatsApp number exists","name":"verify-whatsapp-number"},{"description":"Generate a structured prompt for testing MCP server connectivity","name":"ping-server"},{"description":"Generate a structured prompt for checking server and device health","name":"check-server-health"},{"description":"Generate a structured prompt for retrieving WhatsApp devices with filtering options","name":"get-whatsapp-devices-overview"},{"description":"Generate a structured prompt for monitoring WhatsApp device health and performance","name":"monitor-device-health"},{"description":"Generate a structured prompt for analyzing device performance and identifying issues","name":"analyze-device-performance"},{"description":"Generate a structured prompt for retrieving WhatsApp chats with filtering and analysis","name":"get-whatsapp-chats-overview"},{"description":"Generate a structured prompt for analyzing chat patterns, activity, and performance metrics","name":"analyze-whatsapp-chat-patterns"},{"description":"Generate a structured prompt for searching and finding specific chats","name":"search-whatsapp-chats"},{"description":"Find leads that stopped replying and organize them for follow-up, without messaging anyone unless asked","name":"follow-up-quiet-whatsapp-leads"},{"description":"Generate a structured prompt for retrieving messages from specific WhatsApp chats","name":"get-whatsapp-chat-messages"},{"description":"Generate a structured prompt for analyzing conversation patterns and message insights","name":"analyze-whatsapp-chat-conversation"},{"description":"Generate a structured prompt for searching messages across multiple WhatsApp chats","name":"search-messages-across-chats"},{"description":"Generate a structured prompt for WhatsApp group management operations","name":"manage-whatsapp-groups"},{"description":"Generate a structured prompt for managing WhatsApp group participants","name":"manage-group-participants"},{"description":"Generate a structured prompt for analyzing WhatsApp group activity and engagement","name":"analyze-whatsapp-group-activity"},{"description":"Generate a structured prompt for WhatsApp channel management operations","name":"manage-whatsapp-channels"},{"description":"Generate a structured prompt for analyzing WhatsApp channel performance and content","name":"analyze-whatsapp-channel-performance"},{"description":"Generate a structured prompt for discovering and exploring WhatsApp channels","name":"discover-whatsapp-channels"},{"description":"Generate a structured prompt for WhatsApp marketing campaign management","name":"manage-whatsapp-campaigns"},{"description":"Generate a structured prompt for analyzing WhatsApp campaign performance and ROI","name":"analyze-campaign-performance"},{"description":"Generate a structured prompt for managing WhatsApp campaign recipients and contact lists","name":"manage-campaign-contacts"},{"description":"Generate a structured prompt for WhatsApp team member management","name":"manage-whatsapp-team"},{"description":"Generate a structured prompt for WhatsApp department organization and management","name":"manage-whatsapp-departments"},{"description":"Generate a structured prompt for analyzing WhatsApp team performance and productivity","name":"analyze-team-performance"},{"description":"Generate a structured prompt for searching and managing WhatsApp files and media","name":"search-whatsapp-files"},{"description":"Generate a structured prompt for uploading and managing files for WhatsApp messaging","name":"upload-whatsapp-file"},{"description":"Generate a structured prompt for analyzing file usage patterns and storage optimization","name":"analyze-whatsapp-file-usage"},{"description":"Generate a structured prompt for WhatsApp chat label management and organization","name":"manage-whatsapp-labels"},{"description":"Generate a structured prompt for optimizing WhatsApp label organization and workflow efficiency","name":"optimize-whatsapp-label-system"},{"description":"Generate a structured prompt for strategically applying labels to WhatsApp chats for better organization","name":"apply-whatsapp-labels-strategically"},{"description":"Create and publish WhatsApp status updates with text, images, or videos. Perfect for immediate content sharing and brand storytelling.","name":"whatsapp_status_publishing"},{"description":"Schedule WhatsApp status updates for future publishing with advanced timing options. Ideal for content planning and strategic posting.","name":"whatsapp_status_scheduling"},{"description":"Analyze and retrieve WhatsApp status history with comprehensive filtering and insights. Perfect for content performance tracking.","name":"whatsapp_status_analytics"},{"description":"Monitor WhatsApp message queue status, performance, and health metrics. Essential for delivery optimization and system monitoring.","name":"whatsapp_queue_monitoring"},{"description":"Control WhatsApp message queue processing with status management and delivery control. Critical for managing message flow and system operations.","name":"whatsapp_queue_control"},{"description":"Perform bulk operations on WhatsApp message queues including message deletion, filtering, and cleanup. Essential for queue maintenance and management.","name":"whatsapp_queue_operations"},{"description":"Validate and normalize phone number formats according to E.164 international standards. Essential for data quality and contact management.","name":"phone_number_validation"},{"description":"Verify if phone numbers have active WhatsApp accounts and can receive messages. Critical for WhatsApp marketing and communication strategies.","name":"whatsapp_number_verification"},{"description":"Optimize phone number databases and contact management with advanced validation, verification, and data quality improvements.","name":"number_management_optimization"},{"description":"Search for available WhatsApp templates for a specific device","name":"search-whatsapp-templates"},{"description":"Help configure a WhatsApp template message by explaining its variables","name":"configure-template-message"},{"description":"Create a WhatsApp message template and submit it for review, asking for every detail it needs","name":"create-whatsapp-template"},{"description":"Generate a structured prompt for sales pipeline setup and maintenance","name":"manage-sales-pipeline"},{"description":"Generate a structured prompt for sales deal lifecycle management","name":"manage-sales-deals"},{"description":"Generate a structured prompt for sales funnel health analysis","name":"analyze-sales-funnel"}]}