Business & Operations

Peach for WhatsApp Business

by Peach

Overview

Connect ChatGPT directly to your WhatsApp Business API to orchestrate messaging, build trigger-based workflows, and deploy customer-facing AI agents. With the Peach MCP integration, ChatGPT gets administrative and operational tools for your authenticated WhatsApp Business channel: read conversations and message history, send templates and app messages, manage media, schedule targeted broadcasts, build AI support agents, react to Shopify events, route conversations, manage official Meta WhatsApp templates, and keep contacts and pipeline stages up to date from WhatsApp interactions. Turn your WhatsApp number into an active, automated operating system managed directly inside ChatGPT.

Tools

peach_answer_agent_consultation

ChatGPT

Submit an answer to a pending question asked by an autonomous AI agent. Saves the answer, unblocks the agent, and resumes the customer conversation.

peach_archive_broadcast

ChatGPT

Archive a broadcast. Only possible when status is draft or active and no campaign runs are scheduled.

peach_archive_template

ChatGPT

Archive a WhatsApp template (must be approved, rejected, or draft status)

peach_cancel_broadcast

ChatGPT

Cancel all pending/scheduled runs of a broadcast. Use when a broadcast was accidentally launched. Only affects runs that are still scheduled, queued, or queueing — already-sent messages are not recalled.

peach_configure_stage_dropoff

ChatGPT

Configure the drop-off (At risk / Dropped off) behaviour for a pipeline stage. Settings are merged into the stage; omit a field to leave it unchanged.

peach_configure_stage_playbooks

ChatGPT

Bind playbooks (Streams) to a pipeline stage's lifecycle events. Each field is an array of Stream ids (the playbooks) that run when a contact enters/exits the stage or drops off from it. Replaces the existing list for any field provided; omit a field to leave it unchanged.

peach_connect_to_ai_agent

ChatGPT

Send a template message to a contact and connect them to an AI agent for automated follow-up

peach_create_ai_agent

ChatGPT

Create a new AI Agent with system instructions

peach_create_automation

ChatGPT

Create a definition-driven Stream automation (the "what happens": a step-graph of actions). On its own it never runs — pair it with peach_create_trigger (the "when"). Read the peach://guides/automations resource for step types, payload shapes, and event payload schemas before authoring the definition. Classify with playbook_kind: use "notification" only for a single-template notification automation (requires an approved WhatsApp template via send_template.payload.template_message.system_name or builder.template_id — same rule as the UI); use "advanced" for anything else. Opt-in/opt-out playbooks are managed through account setup and cannot be created here.

peach_create_contact

ChatGPT

Create or upsert a single contact in the Peach account

peach_create_contacts

ChatGPT

Create or upsert multiple contacts in bulk in the Peach account

peach_create_pipeline

ChatGPT

Create a new Peach pipeline (board) for this account

peach_create_pipeline_stage

ChatGPT

Create a new stage in a pipeline

peach_create_setup_guest_link

ChatGPT

Create a new guest setup link for WhatsApp onboarding

peach_create_shopify_webhook_subscription

ChatGPT

Subscribe the connected Shopify store to a webhook topic so Peach receives those notifications (idempotent).

peach_create_template

ChatGPT

Create a new WhatsApp template in the Peach account. Must include at least a body component in components_attributes. Template text uses WhatsApp markdown (bold, _italic_, ~strikethrough~, ``monospace``, newlines), NOT HTML/CSS; values containing HTML tags or style attributes are rejected. Placeholders must be named and start with campaign., subscriber. or story., each with a fallback filter, e.g. {{ campaign.order_id | fallback: 'your order' }}; positional ({{1}}) and empty ({{}}) placeholders are rejected, and footers cannot contain placeholders. Read the peach://guides/messaging resource for details.

peach_create_trigger

ChatGPT

Configure a trigger so a Stream automation runs when an event arrives. Choose a condition by its name (the WHEN, e.g. "Order Paid"), supply its variables, and map fields from the event payload into the stream context with JSONPath. The event source is derived automatically. Names come from peach_list_expressions. IMPORTANT: include a recipient data-mapping to the contact's phone (e.g. $.subscriber.phone_number for conversation events, $.contact.phone_number for pipeline events) — without a resolved recipient the stream SILENTLY never runs. After creating, dry-run with peach_evaluate_trigger_condition. See the peach://guides/automations resource for per-event payload paths and the custom-topic caveat.

peach_delete_knowledge_base_document

ChatGPT

Delete a document from an AI Agent knowledge base and its vector search store.

peach_delete_media

ChatGPT

Delete a media file from the Peach account by its ID

peach_delete_pipeline_stage

ChatGPT

Delete a pipeline stage. Fails if the stage still has items or rules.

peach_delete_shopify_webhook_subscription

ChatGPT

Remove a Shopify webhook subscription for the connected store.

peach_enroll_contact_in_pipeline

ChatGPT

Enroll a contact into a pipeline without sending messages. When allow_re_enrollment is enabled and the contact has a terminal or dropped-off active item, archives the prior round and creates a fresh item (source_data.source_item_id links the prior pli_... id).

peach_expire_setup_guest_link

ChatGPT

Expire an existing guest setup link by its numeric id

peach_get_account_setup

ChatGPT

Returns saved account setup properties such as primary goal, communication preferences, and team size.

peach_get_ai_agent

ChatGPT

Get details of a specific AI Agent by its ID, including system instructions, prompt sections (conversation_prompt, business_context), and connected knowledge bases

peach_get_automation

ChatGPT

Get a Stream automation by ID, including its step-graph definition when present

peach_get_broadcast

ChatGPT

Fetch full details for a single broadcast: template, audience, launch configuration, AI agent reply handler, and engagement stats

peach_get_event_status

ChatGPT

Get the status and details of a specific event by its ID

peach_get_onboarding_status

ChatGPT

Returns setup progress and pending onboarding steps for the authenticated account (account setup, phone connection, AI agent configuration, campaign activity).

peach_get_phone_setup_status

ChatGPT

Returns WhatsApp phone setup details, including connection status, connection mode, linked WhatsApp Business Account external ID, and whether AI flows are attached. Use whats_app_business_account_id from here when calling peach_create_template on an account with more than one WhatsApp Business Account.

peach_get_pipeline

ChatGPT

Get a pipeline and its stages

peach_get_template

ChatGPT

Get a specific WhatsApp template by its ID (wat_…), template_name, or system_name. Response includes system_name for notification automation authoring.

peach_launch_broadcast

ChatGPT

Create and launch a broadcast campaign to multiple contacts via the Peach API

peach_list_activities

ChatGPT

List chronological activities (log) for the account or a specific contact, including messages, status changes, and assignments.

peach_list_agent_consultations

ChatGPT

List questions asked by autonomous AI agents awaiting human answers (Needs answer queue). Each consultation includes question, status, urgency, contact info, conversation_id, and AI agent info.

peach_list_ai_agent_sessions

ChatGPT

List recent real/customer-facing interaction sessions (StreamSessions) for a specific AI Agent. Test sessions are available through peach_list_test_sessions.

peach_list_ai_agents

ChatGPT

List AI Agents (AiFlow) in the Peach account (both autonomous and legacy flows)

peach_list_automations

ChatGPT

List Stream automations configured in Peach

peach_list_broadcasts

ChatGPT

List broadcast campaigns for the account, with optional filters

peach_list_coexistence_numbers

ChatGPT

List WhatsApp Business App (coexistence) numbers linked to this account, with their assignee and synced contact list. Call this first when a question is specifically about Business App DMs. Note this lists only coexistence numbers — the account may also have Cloud API numbers that can be read from and replied on.

peach_list_conversations

ChatGPT

List conversations for the account. Supports filtering by status, escalation, activity type, business number, and time windows.

peach_list_expressions

ChatGPT

List the trigger condition library (expressions). Each expression describes WHEN a trigger fires (e.g. "Order Paid", "Fires on topic") and the variables it needs. Reference one by id when creating a trigger.

peach_list_knowledge_bases

ChatGPT

List knowledge bases and their indexed documents in the Peach account. Optionally filter by an AI Agent ID.

peach_list_media

ChatGPT

List media files uploaded to the Peach account

peach_list_messages

ChatGPT

List messages in the Peach account with optional filters. Each message includes conversation_id and the contact who sent/received it, so one call is enough to attribute messages to people — do not fetch conversations separately just to identify them. Messages with an attached media file (voice notes, images, videos, documents) include a media_url field with a downloadable URL for the attachment.

peach_list_pipeline_items

ChatGPT

List active items in a pipeline

peach_list_pipelines

ChatGPT

List active Peach pipelines for this account

peach_list_shopify_webhook_subscriptions

ChatGPT

List the Shopify webhook subscriptions currently registered for the connected store.

peach_list_shopify_webhook_topics

ChatGPT

List common Shopify webhook topics you can subscribe to (e.g. ORDERS_PAID, ORDERS_FULFILLED).

peach_list_template_messages

ChatGPT

List template messages sent via the Peach API with optional filters

peach_list_templates

ChatGPT

List all WhatsApp templates in the Peach account. Each row includes id (wat_… prefix_id), template_name, and system_name (Meta slug used by send_template steps).

peach_list_test_sessions

ChatGPT

List in-app AI Agent test sessions created from MCP or the Peach test UI

peach_list_triggers

ChatGPT

List the triggers configured on a Stream automation (what fires it and the data it maps in)

peach_move_pipeline_item

ChatGPT

Move a pipeline item to another stage

peach_pause_template

ChatGPT

Pause an approved WhatsApp template to temporarily stop it from being used

peach_regenerate_setup_guest_link

ChatGPT

Regenerate a guest setup link by its numeric id (rotates this link to a new one)

peach_reorder_pipeline_stages

ChatGPT

Reorder the stages of a pipeline to match the given ordered list of stage IDs

peach_reply_to_conversation

ChatGPT

Reply to an existing conversation on any connected business number (Cloud API or WhatsApp Business App). Sends a free-form message when a 24-hour customer service window is open; when every window has closed, supply whats_app_template_id to send an approved template instead.

peach_search_contacts

ChatGPT

Search contacts by name, phone number, or email. Optionally restrict to contacts synced from a specific business number.

peach_send_app_message

ChatGPT

Trigger a flow or app-initiated message to a contact via the Peach API

peach_send_template_message

ChatGPT

Send a WhatsApp template message to a contact via the Peach API

peach_send_test_message

ChatGPT

Send a follow-up user message to an existing in-app AI Agent test session

peach_send_test_template_message

ChatGPT

Send or generate a WhatsApp test message for an approved template or broadcast. Use generate_share_link for a user-initiated WhatsApp link that avoids frequency capping.

peach_start_test_session

ChatGPT

Start an isolated in-app test session for an AI Agent using a first user message

peach_submit_template

ChatGPT

Submit a WhatsApp template for review and approval by Meta

peach_trigger_automation

ChatGPT

Trigger a Stream automation for a contact using the same event lifecycle as the public API

peach_update_ai_agent

ChatGPT

Update an existing AI Agent and/or its system instructions

peach_update_automation

ChatGPT

Update a Stream automation definition or metadata. When you change the definition, you must supply playbook_kind again ("notification" only for a single-template notification automation; "advanced" for anything else). If a Notification automation grows beyond the single-template shape, reclassify it as "advanced". Name/description/status-only updates preserve the existing kind.

peach_update_contact

ChatGPT

Update an existing contact identified by their phone number

peach_update_conversation

ChatGPT

Update the status of a conversation (e.g. close, reopen, set to pending)

peach_update_pipeline

ChatGPT

Update a pipeline's name, description, item labels, or lifecycle settings. Omit a field to leave it unchanged.

peach_update_pipeline_item

ChatGPT

Update a pipeline item's title or assignee

peach_update_pipeline_stage

ChatGPT

Update a pipeline stage name, color, or type

peach_update_template

ChatGPT

Update an existing WhatsApp template's components or category

peach_update_trigger

ChatGPT

Update a trigger's variables, data mappings, description, or activation state

peach_upload_knowledge_base_document

ChatGPT

Upload a document (markdown, text, PDF, etc.) to an AI Agent knowledge base. If knowledge_base_id is not specified, uses or creates the default knowledge base for the agent. Synchronizes the document to Gemini File Search vector store.

peach_upload_media

ChatGPT

Upload a media file to Peach using base64-encoded file content. Returns media_url ("media://<id>") to pass straight to peach_reply_to_conversation or a template media header. Max 10MB decoded, and WhatsApp per-type caps apply (images 5MB, video/audio 16MB, documents 100MB).

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Links

Documentation ↗Privacy Policy ↗

App Stats

Tools

Prompts

ChatGPT

Platforms