Crear enlace de reunión

Crea un nuevo enlace de reunión de WhatsApp para una llamada de voz o videollamada.

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

POST https://api.getincloud.ai/v1/devices/{deviceId}/meeting-links

Crea un nuevo enlace de reunión de WhatsApp para una llamada de voz o videollamada.

Usa los enlaces de reunión para crear una nueva sesión de llamada de voz o video con cualquier usuario de WhatsApp mediante un simple enlace URL.

Ejemplo de enlace URL: https://call.whatsapp.com/voice/AhF2Ddl9j32Hf01

Opcionalmente, puedes establecer una descripción del mensaje para recordar el propósito de la llamada y un tiempo de expiración.

De forma predeterminada, los enlaces de reunión expiran en 15 días si no se utilizan. Cuando un enlace de reunión se utiliza, expira automáticamente.

Importante: la sesión del número debe estar en línea para poder generar un nuevo enlace de reunión; de lo contrario, la API devolverá un error 503 Not Available.

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y prueba la API en el probador en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`kind`	string	Sí	Tipo de llamada: video o voz `enum: ['voice', 'video']` · `default: voice`
`message`	string	No	Nota privada opcional del mensaje de la llamada que describe el propósito de la llamada `maxLength: 500`
`expiration`	string	No	Tiempo de expiración del enlace de la llamada `enum: ['1h', '2h', '8h', '12h', '24h', '2d', '3d', '4d', '5d', '6d', '7d', '15d', '30d']` · `default: 30d`

Respuestas

Código	Descripción
`200`	Enlace de reunión creado
`400`	Datos de consulta o del cuerpo de la solicitud no válidos
`401`	Acceso no autorizado debido a un token de API no válido o expirado
`403`	Operación no compatible: se requiere actualizar el plan
`404`	Número no encontrado
`409`	Ya existe un canal con el mismo nombre
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Operación o sesión de WhatsApp no disponible: inténtalo de nuevo

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Create a new video meeting link
curl --request POST \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/meeting-links \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"kind":"video","message":"Sample call purpose description, up to 500 characters"}'


// Create a new voice meeting link
curl --request POST \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/meeting-links \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"kind":"voice","message":"Sample call purpose description, up to 500 characters"}'

AnteriorCrear departamento SiguienteCrear etiqueta

¿Te sirvió esta página?