Skip to content
Amazon Seller Skills v0.1.0 Reference

Message Amazon Buyers About an Order

Send the order message Amazon allows: check the order's message types, draft in the buyer's language, attach documents, and send only after you approve. The Buyer Messaging Skill works through the Messaging API on the Selling Partner MCP, reads the buyer's preferred language, holds every draft to Amazon's content rules, and sends nothing the seller hasn't seen word for word. It needs the Buyer Communication role on the seller's Selling Partner API app; attachments also need an AI client that can run a shell (curl and openssl) to upload the file.

Exact preview, then send
Example output visualization: Send preview
Send preview
skill output
Field
Value
Message type
Unexpected problem
Language
en-US
Text
412 / 2000 characters
Status
awaiting your send
Primary input
An Amazon order ID, or details to find the order
Primary output
A preview per order: type, language, character count, exact text
Powered by
Amazon Selling Partner MCP
Source contract
amazon-sp-messaging-api
PolyForm-Shield-1.0.0
Is this the right Skill?

Use it for a clear operating job.

Best for
  • Delay and unexpected-problem notices
  • Customization and delivery questions
  • Invoices, warranties and legal documents
Use another path when

Review requests, replies to buyer messages, or marketing. The Messaging API has no inbox, review requests go through the Solicitations API, and Amazon bars promotional messages.

Starter prompt

Start with the task, then add your scope.

Copy this into a connected client and replace the account, date, ASIN, or threshold details with yours.

Order 113-1234567-1234567 is delayed two days. Check which message types it allows, draft a note in the buyer's language, and show me the exact text before anything is sent.
The Skill will request any required context or approval before guarded actions.
The outcome

A defined result, not a generic answer.

An order message of the right type, in the buyer's language, sent only after the seller approves the exact text, with a result for every order.

Inputs
  • An Amazon order ID, or details to find the order
  • What the seller needs to tell the buyer
  • The Buyer Communication role on the seller's Selling Partner API app
  • For invoice, warranty or legal disclosure messages: the file, and a client that can run a shell to upload it
Outputs
  • A preview per order: type, language, character count, exact text
  • The sent message, after approval
  • A result per order: sent, failed, unknown or skipped
Workflow

The playbook your agent follows.

  1. 01

    Pin down the order

    Find the order and its marketplace from the order ID or a description. The Skill asks for no buyer personal data; Amazon addresses the message.

  2. 02

    Check what the order allows

    Read the message types the order allows right now and the buyer's preferred language. A type that isn't listed is left out, never swapped for another.

  3. 03

    Draft within Amazon's rules

    Match the purpose to one type and write within its length limit, in the buyer's language, with no marketing, review request, link or contact details.

  4. 04

    Preview, approve, send

    Show the exact text for every order, send only on a clear go-ahead at one message per second, and report each result.

Guardrails

What keeps the workflow dependable.

Nothing is sent that the seller hasn't approved word for word
A send that timed out is never retried blindly; it is reported as unknown
No review requests, promotions or outside contact details in any message
Connected systems

The context and tools it coordinates.

Amazon Selling Partner MCP
Messaging API
Uploads API
amazon-sp-messaging-api

Give your agent the complete playbook.

Connect Skills once, then start with the prompt above whenever this job comes up.