Listar conexiones

Recupera las conexiones (rutas o proveedores vinculados) disponibles en tu cuenta.

API de Mensajería

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

Este endpoint permite recuperar una lista de todas las conexiones (rutas o proveedores vinculados) disponibles en tu cuenta. Las conexiones representan los canales técnicos configurados para el envío de mensajes.

GET https://api.getincloud.online/raven/v3/connections

Parámetros de la consulta

Campo	Tipo	Obligatorio	Descripción
status	string	No	Filtra por estado actual. Valores permitidos: ACTIVE (Activa) o INACTIVE (Inactiva).
channel	string	No	Filtra por canal de comunicación. Ejemplo: sms, whatsapp, email.

Encabezados

Campo	Tipo	Obligatorio	Descripción
Authorization	string	Sí	Token de portador. Formato: Bearer <TU_TOKEN>.
accept	string	No	application/json.

Respuestas

200 OK

La solicitud se procesó correctamente y se devuelve la lista de conexiones.

Campo	Tipo	Descripción
connections	array de objetos	Lista con los detalles de cada conexión.
connections[].id	string	Identificador único de la conexión. Puede usarse en el parámetro connection al enviar un mensaje.
connections[].name	string	Nombre descriptivo de la conexión.
connections[].channel	string	Canal de mensajería asociado (ej. sms).
connections[].status	string	Estado operativo de la conexión.
connections[].config	objeto	Información de configuración técnica específica de la conexión.

401 Unauthorized

Fallo de autenticación por token inválido, inexistente o expirado.

{
 &quot;error&quot;: &quot;Unauthorized&quot;
}

500 Internal Server Error

Error interno en el servidor al procesar la solicitud.

Notas técnicas

El id obtenido en este endpoint es el que debes usar en el parámetro opcional connection de las APIs de envío (/messages o /messages/batch). Así puedes forzar el envío por una ruta específica si tu cuenta tiene múltiples proveedores configurados.

Ejemplo de solicitud

curl --request GET \
 --url https://api.getincloud.online/raven/v3/connections \
 --header 'accept: application/json' \
 --header 'Authorization: Bearer &lt;TU_TOKEN&gt;'

AnteriorInformación del proceso de reenvío SiguienteListar correos electrónicos

¿Te sirvió esta página?