К основному содержанию
скилл CX Codex GP ChatGPT официальный · OpenAI

twilio-whatsapp-manage-senders — скилл для Codex: обзор и установка

Скилл twilio-whatsapp-manage-senders регистрирует и настраивает бизнес-номера WhatsApp через Twilio Channels Senders API. Помогает пройти верификацию по OTP, задать профиль и подключить вебхуки.

MIT 1 установок ★ 8 052 обновлён 2026-10-08

Установить в Codex · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add openai/plugins --skill twilio-whatsapp-manage-senders -a codex
Открыть на GitHub

Что делает twilio-whatsapp-manage-senders

Скилл автоматизирует работу с отправителями WhatsApp Business через Twilio SDK на Python или Node.js. С его помощью агент запускает регистрацию номера, передаёт код верификации из SMS или голосового звонка и отслеживает статусы жизненного цикла от CREATING до ONLINE.

Также инструмент задаёт профиль компании с адресом и сайтом, настраивает входящие вебхуки и управляет привязкой номеров в сценариях ISV через waba_id. При возникновении ошибок или статуса OFFLINE скилл проверяет массив offlineReasons, выявляя проблемы вроде кода 63020.

На пробном аккаунте Twilio запустить боевой номер не получится: регистрация работает только после апгрейда счёта. Без подтверждения Meta Business Manager Twilio разрешает подключить не более двух номеров.

Какие задачи решает

  • зарегистрировать рабочий номер телефона в WhatsApp Business через Twilio API
  • подтвердить регистрацию входящим кодом из SMS или голосового звонка
  • настроить вебхуки для входящих сообщений и уведомлений о статусе доставки
  • заполнить бизнес-профиль компании с описанием, логотипом и адресом

Примеры запросов агенту

  • Зарегистрируй номер +15017122661 в WhatsApp Business через Twilio и запроси код по SMS
  • Отправь код подтверждения 123456 для отправителя XExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • Обнови профиль WhatsApp для номера: укажи название Acme Support и адрес вебхука

Как установить twilio-whatsapp-manage-senders

1Через Skills CLI (Vercel)

npx skills add openai/plugins --skill twilio-whatsapp-manage-senders -a codex

2Вручную: положить файлы

.agents/skills/twilio-whatsapp-manage-senders/SKILL.md

Для всех проектов — ~/.agents/skills/

По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать

Вопросы о twilio-whatsapp-manage-senders

Как установить twilio-whatsapp-manage-senders в Codex?

Выполните команду npx skills add openai/plugins --skill twilio-whatsapp-manage-senders -a codex в терминале. Также можно сохранить файл навыка по пути .agents/skills/twilio-whatsapp-manage-senders/SKILL.md.

Что делает twilio-whatsapp-manage-senders?

Скилл генерирует код для регистрации номеров в WhatsApp Business через Twilio API, проверяет статусы жизненного цикла и настраивает бизнес-профили.

Сколько номеров можно подключить без верификации в Meta?

Без подтверждения компании в Meta Business Manager действует ограничение: не более двух отправителей. Для верифицированного бизнеса лимит составляет 20 номеров.

Исходный текст

SKILL.md · MIT
---
name: twilio-whatsapp-manage-senders
description: >
  Create, configure, and manage WhatsApp Business senders via Twilio's
  Channels Senders API. Covers programmatic sender registration, profile setup,
  webhook configuration, sender lifecycle statuses, and ISV flows. Use this
  skill to register and manage production WhatsApp senders at scale.
---

## Overview

A WhatsApp sender is a phone number registered with WhatsApp Business through Twilio. Registration goes through a lifecycle of statuses before becoming `ONLINE`. Sandbox testing does not require a registered sender — see `twilio-whatsapp-send-message`.

---

## Prerequisites

- Upgraded Twilio account (trial accounts cannot register production senders)
  — See `twilio-account-setup` for signup and upgrade steps
- A phone number capable of receiving SMS or voice verification
- Number must not already be registered with WhatsApp
- Environment variables:
  - `TWILIO_ACCOUNT_SID`
  - `TWILIO_AUTH_TOKEN`
  — See `twilio-iam-auth-setup` for credential setup and best practices
- SDK: `pip install twilio` / `npm install twilio`

---

## Quickstart

**Python**
```python
import os
from twilio.rest import Client

client = Client(os.environ["TWILIO_ACCOUNT_SID"], os.environ["TWILIO_AUTH_TOKEN"])

# Step 1: Initiate registration
sender = client.messaging.v2.channels.senders.create(
    sender_id="whatsapp:+15017122661",
    verification_method="sms"
)
print(sender.sid)     # XExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
print(sender.status)  # CREATING

# Step 2: Submit the OTP Twilio sends to the number
sender = client.messaging.v2.channels.senders(sender.sid).update(
    verification_code="123456"
)
print(sender.status)  # ONLINE (may pass through TWILIO_REVIEW first)
```

**Node.js**
```node
const twilio = require("twilio");
const client = twilio(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN);

// Step 1: Initiate registration
const sender = await client.messaging.v2.channels.senders.create({
    senderId: "whatsapp:+15017122661",
    verificationMethod: "sms",
});
console.log(sender.sid, sender.status);

// Step 2: Submit the OTP
const verified = await client.messaging.v2.channels.senders(sender.sid).update({
    verificationCode: "123456",
});
console.log(verified.status);
```

---

## Sender Lifecycle Statuses

| Status | Meaning |
|--------|---------|
| `CREATING` | Registration initiated |
| `PENDING_VERIFICATION` | Awaiting OTP submission |
| `VERIFYING` | OTP being validated |
| `TWILIO_REVIEW` | Under Twilio/Meta review |
| `ONLINE` | Active and ready to send |
| `OFFLINE` | Inactive — check `offlineReasons` |
| `DRAFT` | Incomplete registration |

---

## Key Patterns

### Set Business Profile

**Python**
```python
sender = client.messaging.v2.channels.senders(SENDER_SID).update(
    profile_name="Acme Support",
    profile_about="Official support channel for Acme Corp",
    profile_address="123 Main St, San Francisco, CA",
    profile_vertical="PROFESSIONAL_SERVICES",
    profile_logo_url="https://acme.com/logo.png",
    profile_websites=["https://acme.com"]
)
```

**Node.js**
```node
const sender = await client.messaging.v2.channels.senders(SENDER_SID).update({
    profileName: "Acme Support",
    profileAbout: "Official support channel for Acme Corp",
    profileAddress: "123 Main St, San Francisco, CA",
    profileVertical: "PROFESSIONAL_SERVICES",
    profileLogoUrl: "https://acme.com/logo.png",
    profileWebsites: ["https://acme.com"],
});
```

### Configure Webhooks

**Python**
```python
sender = client.messaging.v2.channels.senders(SENDER_SID).update(
    callback_url="https://yourapp.com/whatsapp/inbound",
    callback_method="POST",
    status_callback_url="https://yourapp.com/whatsapp/status"
)
```

**Node.js**
```node
await client.messaging.v2.channels.senders(SENDER_SID).update({
    callbackUrl: "https://yourapp.com/whatsapp/inbound",
    callbackMethod: "POST",
    statusCallbackUrl: "https://yourapp.com/whatsapp/status",
});
```

### Retrieve and List Senders

**Python**
```python
sender = client.messaging.v2.channels.senders(SENDER_SID).fetch()
print(sender.status)

for s in client.messaging.v2.channels.senders.list():
    print(s.sid, s.status)
```

**Node.js**
```node
const sender = await client.messaging.v2.channels.senders(SENDER_SID).fetch();
const senders = await client.messaging.v2.channels.senders.list();
senders.forEach(s => console.log(s.sid, s.status));
```

If a sender is `OFFLINE`, check the `offlineReasons` array in the response (e.g. code `63020` means business hasn't accepted Twilio's Meta invitation).

### Migrate an Existing WhatsApp Number

If a number is already registered on WhatsApp (personal or business):
1. Check: `https://wa.me/<PHONE_NUMBER>?text=hi`
2. Delete the existing WhatsApp account on the device, or disable 2FA on the competing platform
3. Proceed with registration above

### ISV / Tech Provider Flow

Register senders under a client's WhatsApp Business Account (WABA):

**Python**
```python
sender = client.messaging.v2.channels.senders.create(
    sender_id="whatsapp:+15017122661",
    waba_id="client-waba-id"
)
```

**Node.js**
```node
const sender = await client.messaging.v2.channels.senders.create({
    senderId: "whatsapp:+15017122661",
    wabaId: "client-waba-id",
});
```

The client must accept Twilio's invitation in their Meta Business Manager.

---

## CANNOT

- **Cannot register a phone number to multiple WABAs** — Each number belongs to one WABA at a time
- **Cannot exceed 2 senders without Meta Business Verification** — Unverified accounts are limited to 2
- **Cannot exceed 20 senders without exception** — Verified Meta Business Manager: max 20 (50 with exception request)
- **Cannot verify phone number only via SMS** — Voice verification is available if SMS cannot be received

---

## Next Steps

- **Send WhatsApp messages with this sender:** `twilio-whatsapp-send-message`
- **Create message templates:** `twilio-content-template-builder`
- **Send WhatsApp OTPs:** `twilio-verify-send-otp`

© Twilio · MIT · openai/plugins

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
mcp-twilio codespar Подключает Twilio к агенту: отправка SMS и WhatsApp, голосовые звонки, 2FA через Verify и проверка номеров через Lookup. CX Codex +1 ★ 279звёзд репо twilio-communications sickn33 Скилл twilio-communications для Claude Code помогает агенту писать интеграции Twilio для SMS, звонков, WhatsApp API и двухфакторной аутентификации с учётом лимитов и правил безопасности. CX Codex +1 1 000установок twilio-verify-send-otp twilio Скилл twilio-verify-send-otp помогает добавить в приложение отправку одноразовых кодов и проверку введённого OTP через Twilio Verify. Подходит для подтверждения телефона или email и двухфакторной аутентификации. CX Codex +1 191установок twilio-marketing-promotions-advisor twilio Скилл twilio-marketing-promotions-advisor помогает спланировать архитектуру маркетинговых рассылок в Twilio: выбрать каналы, подготовить комплаенс A2P 10DLC и настроить трекинг доставки. CX Codex +1 162установок twilio-webhooks hookdeck Скилл twilio-webhooks помогает принимать и проверять вебхуки Twilio, разбирать SMS, звонки и статусы сообщений. Нужен при настройке обработчика или поиске ошибок подписи. CX Codex +1 127установок integrate-whatsapp gokapso Скилл integrate-whatsapp для Claude Code, Codex, Cursor и других агентов, который ведёт интеграцию WhatsApp через Kapso: онбординг клиентов, вебхуки, отправка сообщений, шаблонов и медиа. CX Codex +1 5 400установок

Из того же набора567

Весь набор →
building-ai-agent-on-cloudflare Скилл building-ai-agent-on-cloudflare генерирует код AI-агентов на Cloudflare Agents SDK с WebSockets и Durable Objects. Помогает настроить персистентное состояние, вызовы моделей и отложенные задачи в Workers. CX Codex GP ChatGPT +1 2установок vercel-connect Помогает настроить Vercel Connect для безопасного получения токенов OAuth к внешним API (Slack, GitHub или MCP-серверам) через Vercel OIDC. CX Codex GP ChatGPT +1 1установок knowledge-update Скилл knowledge-update для Codex и ChatGPT. Подгружает в сессию актуальные сведения о Vercel и исправляет устаревшие знания модели о Edge Functions, конфигах и лимитах. CX Codex GP ChatGPT +1 1установок eve Скилл для работы с eve — фреймворком долгосрочных AI-агентов. Помогает создавать, отлаживать и выбирать архитектуру для проектов на eve. CX Codex GP ChatGPT +1 1установок twilio-voice-conversation-relay Скилл twilio-voice-conversation-relay для построения голосовых AI-агентов на Twilio с обработкой речи в реальном времени. CX Codex GP ChatGPT +1 1установок twilio-send-message Скилл twilio-send-message для Codex и ChatGPT отправляет сообщения через Twilio Programmable Messaging API: SMS, MMS, RCS и WhatsApp. Канал выбирается по адресу получателя и его возможностям. CX Codex GP ChatGPT +1 1установок twilio-messaging-overview twilio-messaging-overview — скилл для Codex, который объясняет каналы Twilio Messaging и выбор между SMS, WhatsApp, RCS и Facebook Messenger. Он ведёт от первого сообщения к настройке отправителей и мониторинга. CX Codex GP ChatGPT +1 1установок twilio-account-setup Скилл twilio-account-setup проведёт от регистрации в Twilio до первого отправленного сообщения: креды, номер, SDK, сабаккаунты. CX Codex GP ChatGPT +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой