> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wovepay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompts

> Prompts MCP registrados pelo WovePay MCP Server para fluxos comuns

O MCP registra **prompts** que clientes compatíveis (como Cursor) podem sugerir automaticamente.

## Pagamentos e API

| Prompt                 | Descrição                                      |
| ---------------------- | ---------------------------------------------- |
| `create-pix-payment`   | Criar cobrança PIX com `externalReference`     |
| `create-webhook`       | Registrar endpoint HTTPS + eventos             |
| `create-checkout`      | Fluxo loja: produto + link de pagamento        |
| `configure-split`      | Split interno entre contas WovePay             |
| `generate-sdk-example` | Snippet Node/Python/cURL para um `operationId` |
| `test-api-key`         | Diagnóstico de autenticação e permissões       |

## Bots e tempo real

| Prompt                  | Descrição                                               |
| ----------------------- | ------------------------------------------------------- |
| `bot-discord-payment`   | Bot Discord: PIX + WebSocket para liberar cargo/produto |
| `bot-telegram-payment`  | Bot Telegram: cobrança e entrega via WebSocket          |
| `bot-whatsapp-payment`  | Bot WhatsApp sem URL pública                            |
| `websocket-realtime`    | Conectar ao WSS e receber `payment.*`                   |
| `webhook-vs-websocket`  | Decidir entre webhook e WebSocket                       |
| `discord-vip-role`      | Venda de cargo VIP no Discord                           |
| `telegram-paid-channel` | Monetizar canal/grupo Telegram                          |
| `bot-error-recovery`    | Recuperar após queda de WebSocket                       |
| `polling-to-websocket`  | Migrar de polling REST para WebSocket                   |
| `analyze-payment-event` | Analisar evento `payment.paid`                          |

## Como usar no Cursor

1. Conecte o servidor MCP WovePay
2. No chat, digite `/` ou use o seletor de prompts
3. Escolha um prompt (ex: `bot-discord-payment`)
4. Preencha os argumentos sugeridos

## Exemplo: bot Discord

O prompt `bot-discord-payment` orienta o agente a:

1. Chamar `recommend_integration_mode` com `platform=discord`
2. Ler `WovePay://bots-playbook` e `WovePay://websocket`
3. Criar PIX com `externalReference` = `discord:{guildId}:{orderId}`
4. Conectar WebSocket no worker do bot (nunca no client)
5. Liberar cargo no `payment.paid` e enviar `ack`

## Exemplo: webhook vs WebSocket

Use `webhook-vs-websocket` ou a tool `recommend_integration_mode`:

* **Bot / worker sem HTTPS** → WebSocket (`wss://ws.WovePay.com.br/v1`)
* **API REST / serverless com HTTPS** → Webhook + HMAC
* **App mobile / frontend** → Backend próprio (nunca exponha `wp_live_...` no client)