Appearance
Send Video Message
About 753 wordsAbout 3 min
Send Video Messages
Sends a message with a video attached via a URL.
Send a message that includes a video. Provide the video via a publicly accessible URL in the media_url parameter.
You can optionally include caption text in the message parameter.
💡 Note: Supported video formats: MP4, 3GPP. Maximum file size: 16MB.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
group_id | string | Yes | The WhatsApp group JID (example: 12345@g.us). |
message | string | No | Text content of the message. Required for text, buttons, interactive, and optional for others. |
message_type | string | Yes | Type of message to send. One of: text, image, video, audio, document, location, buttons, interactive. |
media_url | string | Yes | URL of media file (image/video/audio/document) to send, depending on message_type. |
file_name | string | No | File name for documents (e.g. document.pdf). |
mimetype | string | Yes | MIME type of media, e.g., image/jpeg, video/mp4, audio/mp4, application/pdf. |
latitude | number | No | Latitude coordinate for location messages. |
longitude | number | No | Longitude coordinate for location messages. |
buttons | array | No | Array of button objects for interactive messages. Each button should have buttonId and displayText. |
quoted_message_id | string | No | ID of the message to quote (reply to). |
quoted_message | string | No | Fallback text content for the quoted message if the original message is not found in the store. |
API Endpoint
POST https://app.rapiwa.com/api/group/send-messageHeader
Content-Type: application/json
Authorization: Bearer Your_Device_KeyBody
{
"group_id": "XXXXXXXXXXXX",
"message_type": "video",
"message": "Here is a video for you!",
"media_url": "https://rapiwa.com/xyz.mp4",
"mimetype": "video/mp4"
}###Response:
{
"success": true,
"message_type": "video",
"message_id": "XXXXXXXXXXXXXXXXXXXXXX",
"to": "XXXXXXXXXXXXX"
}Code examples
bash
curl -X POST "https://app.rapiwa.com/api/group/send-message" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer Your_Device_Key" \
-d '{"group_id":"XXXXXXXXXXXX","message_type":"video","message":"Here is a video for you!","media_url":"https://rapiwa.com/xyz.mp4","mimetype":"video/mp4"}'python
import requests
url = "https://app.rapiwa.com/api/group/send-message"
headers = {"Content-Type": "application/json", "Authorization": "Bearer Your_Device_Key"}
payload = {"group_id": "XXXXXXXXXXXX", "message_type": "video", "message": "Here is a video for you!", "media_url": "https://rapiwa.com/xyz.mp4", "mimetype": "video/mp4"}
requests.post(url, json=payload, headers=headers)javascript
await fetch('https://app.rapiwa.com/api/group/send-message', {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer Your_Device_Key' },
body: JSON.stringify({ group_id: 'XXXXXXXXXXXX', message_type: 'video', message: 'Here is a video for you!', media_url: 'https://rapiwa.com/xyz.mp4', mimetype: 'video/mp4' })
});php
<?php
$data = ['group_id' => 'XXXXXXXXXXXX', 'message_type' => 'video', 'message' => 'Here is a video for you!', 'media_url' => 'https://rapiwa.com/xyz.mp4', 'mimetype' => 'video/mp4'];
$options = ['http' => ['header' => "Content-Type: application/json\r\nAuthorization: Bearer Your_Device_Key\r\n", 'method' => 'POST', 'content' => json_encode($data)]];
file_get_contents('https://app.rapiwa.com/api/group/send-message', false, stream_context_create($options));ruby
require 'net/http'
require 'json'
uri = URI('https://app.rapiwa.com/api/group/send-message')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer Your_Device_Key'
request.body = { group_id: 'XXXXXXXXXXXX', message_type: 'video', message: 'Here is a video for you!', media_url: 'https://rapiwa.com/xyz.mp4', mimetype: 'video/mp4' }.to_json
Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(request) }go
payload := map[string]interface{}{"group_id": "XXXXXXXXXXXX", "message_type": "video", "message": "Here is a video for you!", "media_url": "https://rapiwa.com/xyz.mp4", "mimetype": "video/mp4"}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://app.rapiwa.com/api/group/send-message", bytes.NewBuffer(body))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer Your_Device_Key")
http.DefaultClient.Do(req)csharp
var payload = new { group_id = "XXXXXXXXXXXX", message_type = "video", message = "Here is a video for you!", media_url = "https://rapiwa.com/xyz.mp4", mimetype = "video/mp4" };
var content = new StringContent(JsonSerializer.Serialize(payload), Encoding.UTF8, "application/json");
client.DefaultRequestHeaders.Add("Authorization", "Bearer Your_Device_Key");
await client.PostAsync("https://app.rapiwa.com/api/group/send-message", content);java
HttpRequest.newBuilder()
.uri(URI.create("https://app.rapiwa.com/api/group/send-message"))
.header("Content-Type", "application/json")
.header("Authorization", "Bearer Your_Device_Key")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"group_id\":\"XXXXXXXXXXXX\",\"message_type\":\"video\",\"message\":\"Here is a video for you!\",\"media_url\":\"https://rapiwa.com/xyz.mp4\",\"mimetype\":\"video/mp4\"}"))
.build();swift
var request = URLRequest(url: URL(string: "https://app.rapiwa.com/api/group/send-message")!)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.setValue("Bearer Your_Device_Key", forHTTPHeaderField: "Authorization")
request.httpBody = try? JSONEncoder().encode(["group_id": "XXXXXXXXXXXX", "message_type": "video", "message": "Here is a video for you!", "media_url": "https://rapiwa.com/xyz.mp4", "mimetype": "video/mp4"])
URLSession.shared.dataTask(with: request).resume()powershell
$body = @{ group_id = "XXXXXXXXXXXX"; message_type = "video"; message = "Here is a video for you!"; media_url = "https://rapiwa.com/xyz.mp4"; mimetype = "video/mp4" } | ConvertTo-Json
Invoke-RestMethod -Uri "https://app.rapiwa.com/api/group/send-message" -Method Post -Headers @{"Content-Type"="application/json"; "Authorization"="Bearer Your_Device_Key"} -Body $bodytypescript
await fetch('https://app.rapiwa.com/api/group/send-message', {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer Your_Device_Key' },
body: JSON.stringify({ group_id: 'XXXXXXXXXXXX', message_type: 'video', message: 'Here is a video for you!', media_url: 'https://rapiwa.com/xyz.mp4', mimetype: 'video/mp4' })
});rust
let payload = json!({"group_id": "XXXXXXXXXXXX", "message_type": "video", "message": "Here is a video for you!", "media_url": "https://rapiwa.com/xyz.mp4", "mimetype": "video/mp4"});
client.post("https://app.rapiwa.com/api/group/send-message").header("Authorization", "Bearer Your_Device_Key").json(&payload).send().await?;💡 Tip: Keep your Device Key secure. Never share it publicly.
