Integração com IA

​

Arquivos disponíveis

​

Cursor

​

Adicionar como documentação (@Docs)

1. Cursor Settings → Indexing & Docs → Add new doc
2. URL: https://docs.wovepay.com/llms.txt
3. Opcional: adicione também https://docs.wovepay.com/openapi.yaml

​

Exemplo de prompt

@Docs Integre a WovePay no meu backend Node.js:
1. Criar cobrança PIX com externalReference
2. Endpoint POST /webhook que valida x-WovePay-signature (HMAC-SHA256)
3. Marcar pedido como pago no evento payment.paid

Use X-API-Key, base https://api.wovepay.com/v1 e o envelope { success, data, requestId }.

​

Regras do projeto (.cursor/rules)

# WovePay API
- Base: https://api.wovepay.com/v1
- Auth: header X-API-Key (wp_live_...)
- Respostas: envelope JSON com success, message, data, requestId
- Webhooks: validar x-WovePay-signature no raw body com whsec_
- Docs: https://docs.wovepay.com/llms.txt
- OpenAPI: https://docs.wovepay.com/openapi.yaml

​

Claude (Projects)

1. Crie um Project para sua integração WovePay
2. Em Project knowledge, adicione:
   • https://docs.wovepay.com/llms.txt
   • openapi.yaml (baixe ou use URL)
3. Nas instruções do projeto, inclua:

Sempre consulte a documentação WovePay antes de sugerir rotas.
Trilho PADRAO vem da API key, não do body.
Não invente campos provider, accountId ou metadata — não existem na API pública.

​

ChatGPT e outros

• Custom instructions / GPT: cole o conteúdo de llms.txt ou aponte a URL
• MCP: use o servidor MCP oficial em mcp.wovepay.com — executa a API, busca docs offline e oferece ferramentas compostas
• API / Agents sem MCP: busque llms.txt no início da sessão e mantenha openapi.yaml para schemas

​

O que pedir à IA (e o que evitar)

​

Boas práticas

​

Evite

​

Fluxo sugerido para agentes

1. Leia llms.txt para escopo e convenções
2. Abra o guia do módulo (ex. /api-reference/guides/pix.md)
3. Use openapi.yaml para tipos de request/response
4. Gere código e teste com valor baixo

​

Bots (Discord, Telegram, WhatsApp)

1. createPaymentPix com externalReference (ex: discord:{guildId}:{orderId})
2. Conecte ao WebSocket, subscribe payment.*
3. No payment.paid, libere produto/cargo e envie ack

​

Links úteis