# Openapi Messaging

> Send communications through Openapi - SMS with custom sender and OTP (SMS v2), Italian certified e-mail (PEC/Legalmail), bulk certified mail (Massive REM), and physical mail via Poste Italiane (registered letters, telegrams, judicial acts). Use when the user wants to send a message, letter or certified communication.

- **Type:** Skill
- **Install:** `agentstack add skill-openapi-openapi-skills-openapi-messaging`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [openapi](https://agentstack.voostack.com/s/openapi)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [openapi](https://github.com/openapi)
- **Source:** https://github.com/openapi/openapi-skills/tree/main/skills/openapi-messaging
- **Website:** https://openapi.com

## Install

```sh
agentstack add skill-openapi-openapi-skills-openapi-messaging
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Openapi messaging & communications

All services use a Bearer token (see the `openapi-auth` skill). **Every send is an outward-facing, paid action: always confirm recipient, content and cost with the user before sending.**

## SMS v2 — `https://sms.openapi.com`

- `POST /IT-messages` (Italy), `POST /ES-messages` (Spain), `POST /WW-messages` (worldwide)
- `POST /otp` — OTP verification messages
- `GET /messages`, `GET /messages/{id}` — sent messages and delivery status

Features: custom sender, E.164 validation, GSM-7/UCS-2 detection with automatic segmentation, **`dry_run` for free testing**, webhook delivery callbacks. Messages expire after 48h (status `EXPIRED`). Worldwide pricing is computed post-sending and requires a minimum credit balance. SMS v1 (`ws.messaggisms.com`) is **deprecated**.

```bash
curl -s -X POST https://sms.openapi.com/IT-messages \
  -H "Authorization: Bearer $OPENAPI_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"sender": "MyBrand", "body": "Hello!", "recipients": ["+39333…"], "options": {"dry_run": true}}'
```

## PEC (certified e-mail) — `https://pec.openapi.it`

Activate and manage Legalmail certified e-mail boxes (creation, renewal, configuration).

## Massive REM — `https://ws.pecmassiva.com`

Bulk certified e-mail sending; check delivery-verification and receipt-verification status per message.

## Postal Service — `https://ws.ufficiopostale.com`

Physical mail via Poste Italiane. Same pattern per product: `POST //` (create, returns prices) → `PATCH //{id}` (confirm, or pass `autoconfirm: true`) → status callbacks to your `callback` URL → `GET //{id}/accettazione` (acceptance receipt).

Products: `raccomandate` and `raccomandate_smart` (registered mail), `telegrammi`, `ordinarie`, `prioritarie`, `posta_massiva`, `posta_massiva_top`, `atti_giudiziari` (judicial acts, with digital return receipt). Helpers: `GET /pricing/`, `GET /nazioni/`, `GET /covers/`, `GET /dug/`. Error responses include `data.wrong_fields[]` pinpointing invalid fields.

Full specs: https://console.openapi.com/oas/en/smsv2.openapi.json · …/pec.openapi.json · …/pecmassiva.openapi.json · …/ufficiopostale.openapi.json

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [openapi](https://github.com/openapi)
- **Source:** [openapi/openapi-skills](https://github.com/openapi/openapi-skills)
- **License:** MIT
- **Homepage:** https://openapi.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-openapi-openapi-skills-openapi-messaging
- Seller: https://agentstack.voostack.com/s/openapi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.