Agent setup guide

AI coding agents can accelerate WhatsApp development. They guide you through workflows that historically required navigating multiple documentation pages, such as connecting a WhatsApp Business Account, adding a tester, sending your first message, and managing templates. AWS End User Messaging Social publishes an agent skill that gives your agent step-by-step, validated guidance for these tasks. An agent configured with your AWS credentials can also run the underlying API calls. Without credentials, the skill provides guidance only.

This skill is part of a set that spans both messaging services. This page covers WhatsApp. For SMS, RCS, voice, and notify (one-time passcode), see the Agent setup guide in the AWS End User Messaging SMS documentation.

Prerequisites

• Install uv on your system.

• (Optional) An AWS account with AWS Identity and Access Management (IAM) credentials configured locally. Credentials are required only for tools that execute AWS End User Messaging Social API calls, not for searching documentation or discovering skills. If you do not have credentials configured, see Setting up the AWS MCP Server.

Step 1 — Connect the AWS MCP Server

The AWS MCP Server, built on the Model Context Protocol (MCP), gives your agent AWS API access, sandboxed execution, and documentation search. Follow Setting up the AWS MCP Server for your agent. The essentials:

Claude Code, Codex, or Cursor

The aws-core plugin bundles the AWS MCP Server configuration and a curated set of skills in one install:

/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-core@agent-toolkit-for-aws

Kiro

Add the server to .kiro/settings/mcp.json:

{
  "mcpServers": {
    "aws": {
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws-cli@latest",
        "https://aws-mcp.us-east-1.api.aws/mcp",
        "--metadata", "AWS_REGION=us-west-2"
      ]
    }
  }
}

Any other agent

See Setting up the AWS MCP Server for the configuration block for your MCP client. Only the configuration file location differs (.cursor/mcp.json, .vscode/mcp.json, and so on).

Step 2 — Install the WhatsApp skill (aws-social-messaging)

For Claude Code, Codex, or Cursor, aws-core already includes the skill, so you can skip this step. For any other agent:

npx skills add aws/agent-toolkit-for-aws/skills --skill aws-social-messaging --yes --global

This skill covers WhatsApp through AWS End User Messaging Social. Try a hero prompt:

Other things to ask:

• Help me create a WhatsApp utility template for order-shipping notifications.

• List my WhatsApp message templates and show which are approved versus pending.

• I want delivery-status and template-status notifications for my WhatsApp Business Account. What are my options?

For the underlying workflows, see the WhatsApp getting-started pages in the AWS End User Messaging Social documentation. For more information, see Getting started with AWS End User Messaging Social.

Keeping the skill current

As AWS End User Messaging Social adds features, future skill releases include updated patterns and guidance, so your agent always works from current best practices.