Canonical page: https://www.kuudo.com/features/skills/amazon-seller/buyer-messaging/

Amazon Seller Skills v0.2.2 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

[Try the starter prompt](#starter-prompt)[Connect Skills](/docs/quick-start/chatgpt-skills/)

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

](/features/amazon-selling-partner-mcp/)[

Source contract

amazon-sp-messaging-api

PolyForm-Shield-1.0.0

](https://github.com/KuudoAI/skills/blob/674e68adc1c0242e5ea440583f82d26c93c86b1d/skills/amazon-sp-messaging-api/SKILL.md)

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.

```text
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

Keep building

## Related workflows and field guides.

[All Amazon Seller Skills →](/features/skills/amazon-seller/)

[Related SkillRefund and return monitor](/features/skills/amazon-seller/refund-return-monitor/)[Related SkillFBA stockout prevention](/features/skills/amazon-seller/fba-stockout-prevention/)[Product surfaceAmazon Selling Partner MCP](/features/amazon-selling-partner-mcp/)

amazon-sp-messaging-api

## Give your agent the complete playbook.

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

[View prompt](#starter-prompt)[Connect Skills](/docs/quick-start/chatgpt-skills/)
