WhatsApp Document Sender

REST API for sending messages and documents via WhatsApp.

原始信息汇总

WhatsApp Document Sender API 数据集概述

基本信息

• 数据集名称: WhatsApp Document Sender
• 类别: SMS
• 提供者: JUAN CARLOS MONDRAGON GARCIA
• 订阅者数量: 0
• 版本: 1.0.0 (current)
• 定价: BASIC $0.00 / ---, PRO $0.00 / ---, ULTRA $0.00 / ---, MEGA $0.00 / ---

概述

这是一个用于通过WhatsApp发送消息和文档的REST API。该API允许客户端创建和管理WhatsApp连接会话、检索用于设备链接的QR码数据、发送文本消息、从公共文件URL发送文档以及检查会话状态。

基础URL

使用您自己部署的端点：YOUR_API_BASE_URL，例如：https://your-domain.com。

主要端点

• POST /connect/{clientId}: 创建或重新连接客户端会话，并可能返回QR数据。
• GET /connect/{clientId}: 返回详细的连接状态。
• GET /qr/{clientId}: 当可用时返回QR码图像（PNG）。
• POST /send/{clientId}: 发送文本或文档。
• GET /status/{clientId}: 返回简化状态（connected true/false）。

请求示例

发送文本

bash curl -X POST "YOUR_API_BASE_URL/send/my-client" -H "Content-Type: application/json" -d {"telefono":"COUNTRYCODE_NUMBER","caption":"Hello from API"}

发送文档

bash curl -X POST "YOUR_API_BASE_URL/send/my-client" -H "Content-Type: application/json" -d {"telefono":"COUNTRYCODE_NUMBER","url_documento":"https://example.com/file.pdf","caption":"Optional caption"}

发送请求体字段

json { "telefono": "COUNTRYCODE_NUMBER", "url_documento": "https://example.com/file.pdf", "caption": "Optional text" }

• telefono (必需): 带有国家/地区代码的目标号码，无空格。
• url_documento (可选): 作为文档发送的公共文件URL。
• caption (可选): 消息文本或文档标题。

合同字段名称（必须保留）

以下字段名称在客户端集成中不应翻译：

• 请求字段: telefono, url_documento, caption
• 响应字段: estado, mensaje, id_mensaje, destinatario

响应示例

成功响应

json { "estado": "sent", "mensaje": "Document sent successfully", "id_mensaje": "ABC123", "destinatario": "COUNTRYCODE_NUMBER" }

错误响应

json { "estado": "failed", "mensaje": "Cliente no conectado" }

注意事项

• 保持相同的clientId以重用现有的链接会话。
• 对于生产部署，请监控正常运行时间和日志。
• 避免在公共文档中暴露私有基础设施URL或内部凭据。
• 本文档为英文，部分请求/响应字段名称因API合同要求仍保留西班牙语。