Crear canal

Crea un nuevo canal público de WhatsApp, opcionalmente con una descripción y una imagen de perfil.

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}/channels

Crea un nuevo canal público de WhatsApp, opcionalmente con una descripción y una imagen de perfil.

Importante: crear un nuevo canal es un proceso lento que puede fallar. Usa este endpoint con cuidado, no crees más de un canal cada 2 minutos y aumenta la tolerancia del tiempo de espera de la solicitud hasta 100 segundos.

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 juega con el probador de API 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
`name`	string	Sí	Nombre del canal `minLength: 1` · `maxLength: 100`
`description`	string	No	Descripción pública del canal de hasta 2048 caracteres `minLength: 1` · `maxLength: 2048`
`image`	object	No	Opcional. Imagen que se usará como nueva foto de perfil del canal. Solo se admiten imágenes PNG y JPEG. Tamaño máximo: 1MB
`image.data`	string	No	Cadena de imagen codificada en Base64 que se usará como foto de perfil del canal. Solo se admiten imágenes PNG y JPEG. Tamaño máximo: 1MB `maxLength: 12000000`
`image.url`	string	No	URL de la imagen que se usará como foto de perfil del canal. Solo se admiten imágenes PNG y JPEG. Tamaño máximo: 1MB `maxLength: 2000`

Respuestas

Código	Descripción
`200`	Canal creado
`400`	Datos de consulta o cuerpo de la solicitud no válidos
`401`	Acceso no autorizado por token de API no válido o caducado
`403`	Operación no admitida: 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 channel
curl --request POST \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/channels \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"name":"Sample channel","description":"Sample channel description, up to 2048 characters"}'

AnteriorConsultar catálogo SiguienteCrear departamento

¿Te sirvió esta página?