Llamada Falsa

POST

api

call

fake

:instance

Llamada Falsa

curl --request POST \
  --url https://api.example.com/api/call/fake/:instance \
  --header 'Content-Type: <content-type>' \
  --header 'token: <token>' \
  --data '
{
  "number": "<string>",
  "duration": 123
}
'

const options = {
  method: 'POST',
  headers: {token: '<token>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({number: '<string>', duration: 123})
};

fetch('https://api.example.com/api/call/fake/:instance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/api/call/fake/:instance"

payload = {
    "number": "<string>",
    "duration": 123
}
headers = {
    "token": "<token>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: no

Descripción

Inicia una llamada de voz que hace sonar el teléfono del destinatario unos segundos y cuelga sola, sin audio ni conexión de medios. Útil para llamar la atención, validar un número o flujos de “sonar y colgar”. El campo duration controla cuántos segundos suena la llamada antes del corte automático: por defecto 8 segundos, rango permitido 1 a 60.

Ejemplos

Llamada falsa simple

Usa la duración por defecto (8 segundos).

curl -X POST "https://ryzeapi.cloud/api/call/fake/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5511999999999"
  }'

await fetch(`https://ryzeapi.cloud/api/call/fake/${process.env.Instance_Name}`, {
  method: "POST",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    number: "5511999999999"
  })
});

import os, requests

requests.post(
    f"https://ryzeapi.cloud/api/call/fake/{os.environ['Instance_Name']}",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "number": "5511999999999"
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "number": "5511999999999"
    }`)
    req, _ := http.NewRequest("POST", "https://ryzeapi.cloud/api/call/fake/"+os.Getenv("Instance_Name"), body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

Sonar por una duración específica

duration: 15 hace que la llamada suene 15 segundos antes de colgar.

curl -X POST "https://ryzeapi.cloud/api/call/fake/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number":   "5511999999999",
    "duration": 15
  }'

await fetch(`https://ryzeapi.cloud/api/call/fake/${process.env.Instance_Name}`, {
  method: "POST",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    number:   "5511999999999",
    duration: 15
  })
});

import os, requests

requests.post(
    f"https://ryzeapi.cloud/api/call/fake/{os.environ['Instance_Name']}",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "number":   "5511999999999",
        "duration": 15
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "number":   "5511999999999",
        "duration": 15
    }`)
    req, _ := http.NewRequest("POST", "https://ryzeapi.cloud/api/call/fake/"+os.Getenv("Instance_Name"), body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

Respuesta exitosa

200 OK

{
  "success":  true,
  "message":  "Call placed successfully",
  "callId":   "3EB08FCF27E532F1D3D3",
  "number":   "5511999999999",
  "duration": 8
}

La llamada es cortada automáticamente por el servidor tras duration segundos. No hay flujo de audio en esta llamada.

Parámetros de ruta

string

requerido

Nombre de la instancia (p. ej., $Instance_Name).

Cabeceras

string

requerido

TokenAccount o TokenInstance.

string

requerido

application/json

Cuerpo de la solicitud

string

requerido

Destino: teléfono (5511999999999) o JID (@s.whatsapp.net).

int

predeterminado:"8"

Segundos que suena la llamada antes de colgar automáticamente. Rango permitido: 1 a 60. Omitido o 0 usa el valor por defecto 8.

Errores

HTTP	Mensaje
400	`Instance name is required`
400	`Invalid request body: <detail>`
400	`Number is required`
400	`Duration must be between 1 and 60 seconds`
404	`instance not found`
500	`<motivo del fallo>`

Envoltorio de error:

{
  "success": false,
  "error": { "message": "Duration must be between 1 and 60 seconds" }
}

Introducción

Instancia

Eventos

Mensajes

Llamadas

Grupos

Comunidades

Newsletter

Perfil

Chat

Chatwoot

Typebot

Observabilidad

Descripción

Ejemplos

Llamada falsa simple

Sonar por una duración específica

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Errores

​Descripción

​Ejemplos

​Llamada falsa simple

​Sonar por una duración específica

​Respuesta exitosa

​Parámetros de ruta

​Cabeceras

​Cuerpo de la solicitud

​Errores

Descripción

Ejemplos

Llamada falsa simple

Sonar por una duración específica

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Errores