create_ai_assistant
ChatGPTCreate a new AI assistant (chatbot) for the user's business. Args: ctx: MCP request context (injected automatically). name: Assistant display name (1 to 100 characters). objective: Brief description of the assistant's role (optional). ai_model_name: OpenAI or LiteLLM model identifier (default `"gpt-4.1-nano"). business_id: Optional UUID of the business. Defaults to the user's first business. Returns: A dict with chatbot_id, name, business_id, ai_model_name`.
get_assistant_instructions
ChatGPTGet the AI instructions configured for a specific assistant. Args: ctx: MCP request context (injected automatically). chatbot_id: UUID of the chatbot/assistant to retrieve instructions for. business_id: Optional UUID of the business. Defaults to the user's first business. Returns: A dict with `chatbot_id, name, system_prompt, base_instructions (list), custom_instructions` (list).
get_conversation_duration
ChatGPTGet conversation duration statistics (avg, min, max) for a specific date. Args: ctx: MCP request context (injected automatically). date: ISO-8601 date string, e.g. `"2026-04-15". timezone: IANA timezone name (default "UTC"). business_id: Optional UUID of the business. Returns: A dict with avg_duration_seconds, min_duration_seconds, max_duration_seconds, sessions_counted`.
get_today_assistant_ratio
ChatGPTGet the AI-vs-human assistant message ratio for a specific date. Args: ctx: MCP request context (injected automatically). date: ISO-8601 date string, e.g. `"2026-04-15". timezone: IANA timezone name (default "UTC"). business_id: Optional UUID of the business. Returns: A dict with ai_assistant_messages, human_assistant_messages, ratio_ai_to_human` (0.0 to 1.0).
get_today_message_stats
ChatGPTGet chat, message, and unique-people counts for a specific date. Args: ctx: MCP request context (injected automatically). date: ISO-8601 date string, e.g. `"2026-04-15". timezone: IANA timezone name (default "UTC"), e.g. "America/Sao_Paulo". business_id: Optional UUID of the business. Defaults to the user's first business. Returns: A dict with date, timezone, chats_count, messages_count, people_count`.
list_connected_assistants
ChatGPTList all AI assistants (chatbots) connected to the authenticated user's iZap account. Args: ctx: MCP request context (injected automatically). business_id: Optional UUID of the business to query. If omitted, the user's first business is used automatically. Returns: A dict with `assistants (list of assistant objects) and total` (int).
list_contacts
ChatGPTList contacts (people who have chatted with the business) with names and phone numbers. Args: ctx: MCP request context (injected automatically). limit: Maximum number of contacts to return (1 to 200, default 50). business_id: Optional UUID of the business. Defaults to the user's first business. Returns: A dict with `contacts (list of {name, phone_number}), total, business_id`.
search_today_messages
ChatGPTSearch through messages on a specific date using a keyword query. Rate-limited to 60 calls per user per day. Applies ILIKE substring matching. Args: ctx: MCP request context (injected automatically). query: Search term (1 to 200 characters). date: ISO-8601 date string. timezone: IANA timezone name (default `"UTC"). limit: Maximum number of results to return (1 to 100, default 20). business_id: Optional UUID of the business. Returns: A dict with results (list), total (int), query, date`.
send_whatsapp_message
ChatGPTSend an outbound WhatsApp text message via the business's connected Cloud API number. This dispatches a real message through Meta's WhatsApp Business Cloud API and cannot be undone. Rate-limited to 50 messages per user per day. Args: ctx: MCP request context (injected automatically). to: Recipient phone number in international format, e.g. `"+5562000000000". body: Message text (1 to 4096 characters). preview_url: Whether to render link previews for URLs in the body (default False). business_id: Optional UUID of the business. Defaults to the user's first business. Returns: A dict with to, message_id (None on failure), status ("sent" or "failed"), business_id, and error` (None unless the send failed).
update_ai_assistant_instructions
ChatGPTUpdate the AI instructions for an existing assistant. At least one of `system_prompt, base_instructions, or custom_instructions must be provided. Omitted fields are left unchanged. Args: ctx: MCP request context (injected automatically). chatbot_id: UUID of the chatbot to update. system_prompt: New system prompt text (replaces existing). base_instructions: List of instruction dicts for the base behavior layer. custom_instructions: List of instruction dicts for business-specific context. business_id: Optional UUID of the business. Returns: A dict with chatbot_id and updated_fields` (list of field names that changed).
