Enviar archivo | Apachiy by Mytems

Endpoint

POST/api/v1/message/sendmedia/{instancia}

URL base: https://apachiy.mytems.cloud

Autenticación

Envía tu token en el encabezado Authorization. El permiso messages:send debe estar habilitado para tu cuenta.

Authorization: Bearer myt_live_TU_TOKEN

Genera el token desde el panel. Guárdalo como secreto y no lo expongas en el navegador, repositorios ni aplicaciones móviles.

Parámetros de la solicitud

Nombre	Tipo	Requerido	Descripción
`instancia`	string	Sí	Número de WhatsApp vinculado a tu cuenta, con código de país y solo dígitos.
`number`	string	Sí	Número de destino con código de país.
`mediatype`	string	Sí	image, document, video o audio.
`media`	string	Sí	Archivo codificado en Base64 o data URL Base64. Máximo 8 MB una vez decodificado.
`filename`	string	Condicional	Obligatorio si mediatype es document; máximo 180 caracteres.
`caption`	string	No	Texto opcional para imagen, documento o video. No se admite para audio.

Para documentos, filename es obligatorio. El audio no admite caption; el archivo completo debe enviarse en Base64.

Ejemplo de solicitud

Cambia el token y los datos de ejemplo por los de tu cuenta.

cURL

curl --request POST \
  --url "https://apachiy.mytems.cloud/api/v1/message/sendmedia/51987654321" \
  --header "Authorization: Bearer myt_live_TU_TOKEN" \
  --header "Accept: application/json"
  --header "Content-Type: application/json" \
  --data '{
    "number": "51999999999",
    "mediatype": "document",
    "media": "BASE64_DEL_ARCHIVO",
    "filename": "comprobante.pdf",
    "caption": "Adjuntamos tu comprobante"
}'

import requests
import json

url = "https:\/\/apachiy.mytems.cloud\/api\/v1\/message\/sendmedia\/51987654321"
headers = {"Authorization": "Bearer myt_live_TU_TOKEN", "Accept": "application/json"}
payload = json.loads("{\n    \"number\": \"51999999999\",\n    \"mediatype\": \"document\",\n    \"media\": \"BASE64_DEL_ARCHIVO\",\n    \"filename\": \"comprobante.pdf\",\n    \"caption\": \"Adjuntamos tu comprobante\"\n}")
response = requests.post(url, headers=headers, json=payload, timeout=30)
print(response.status_code, response.json())

const response = await fetch('https://apachiy.mytems.cloud/api/v1/message/sendmedia/51987654321', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer myt_live_TU_TOKEN',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "number": "51999999999",
    "mediatype": "document",
    "media": "BASE64_DEL_ARCHIVO",
    "filename": "comprobante.pdf",
    "caption": "Adjuntamos tu comprobante"
}),
});

console.log(response.status, await response.json());

<?php

$url = 'https://apachiy.mytems.cloud/api/v1/message/sendmedia/51987654321';
$curl = curl_init($url);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer myt_live_TU_TOKEN', 'Accept: application/json', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(array (
  'number' => '51999999999',
  'mediatype' => 'document',
  'media' => 'BASE64_DEL_ARCHIVO',
  'filename' => 'comprobante.pdf',
  'caption' => 'Adjuntamos tu comprobante',
), JSON_UNESCAPED_UNICODE),
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
echo $status . ' ' . $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "strings"
    "time"
)

func main() {
    req, err := http.NewRequest("POST", "https:\/\/apachiy.mytems.cloud\/api\/v1\/message\/sendmedia\/51987654321", strings.NewReader(`{
    "number": "51999999999",
    "mediatype": "document",
    "media": "BASE64_DEL_ARCHIVO",
    "filename": "comprobante.pdf",
    "caption": "Adjuntamos tu comprobante"
}`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", "Bearer myt_live_TU_TOKEN")
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 30 * time.Second}
    res, err := client.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    responseBody, err := io.ReadAll(res.Body)
    if err != nil { panic(err) }
    fmt.Println(res.StatusCode, string(responseBody))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class Main {
    public static void main(String[] args) throws Exception {
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https:\/\/apachiy.mytems.cloud\/api\/v1\/message\/sendmedia\/51987654321"))
            .timeout(Duration.ofSeconds(30))
            .header("Authorization", "Bearer myt_live_TU_TOKEN")
            .header("Accept", "application/json")
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("{\n    \"number\": \"51999999999\",\n    \"mediatype\": \"document\",\n    \"media\": \"BASE64_DEL_ARCHIVO\",\n    \"filename\": \"comprobante.pdf\",\n    \"caption\": \"Adjuntamos tu comprobante\"\n}"))
            .build();
        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://apachiy.mytems.cloud/api/v1/message/sendmedia/51987654321')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer myt_live_TU_TOKEN'
request['Accept'] = 'application/json'
request['Content-Type'] = 'application/json'
request.body = JSON.generate(JSON.parse(<<~JSON))
{
    "number": "51999999999",
    "mediatype": "document",
    "media": "BASE64_DEL_ARCHIVO",
    "filename": "comprobante.pdf",
    "caption": "Adjuntamos tu comprobante"
}
JSON
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https', read_timeout: 30) { |http| http.request(request) }
puts "#${response.code} #${response.body}"

Respuesta

Estructura real de la respuesta HTTP 200; los valores entre llaves son marcadores de ejemplo.

200 · application/json

{
    "success": true,
    "message": "El mensaje se envió correctamente.",
    "data": {
        "instance": "51987654321",
        "number": "51999999999",
        "provider_id": "ID_DEL_MENSAJE"
    },
    "request_id": "UUID_DE_LA_SOLICITUD"
}

Los datos devueltos pueden variar según la información disponible. Conserva el request_id para consultar el registro de una solicitud.

Errores y límites

Los errores controlados siguen la estructura { "success": false, "error": { "code": "...", "message": "..." } }. Según el caso, puedes recibir 401 por token inválido, 403 por permiso o servicio inactivo, 422 por datos no válidos y 429 por límite alcanzado.

Las consultas se limitan por el cupo mensual de tu plan y por el límite temporal de solicitudes. Revisa el código de error antes de reintentar.

Si la respuesta es 502 provider_error, verifica el chat antes de reenviar: la confirmación del proveedor puede haberse interrumpido y un reintento podría duplicar el mensaje.