Proveedores de elementos multimedia

/v1/settings/application/media/providers

Usa el extremo /v1/settings/application/media/providers a fin de compilar una lista de proveedores de elementos multimedia para el envío de enlaces de elementos multimedia. Una lista de proveedores te permite tener distintos proveedores de elementos multimedia dentro de cada tipo de proveedor y también te permite elegir un proveedor para usarlo después de solicitarlo.

Recuperación

Usa esta solicitud de la API para recuperar la lista de proveedores.

Ejemplo

GET /v1/settings/application/media/providers

Una respuesta satisfactoria incluye la lista de proveedores:

"settings": {
        "application": {
            "media": {
                "providers": [ 
                    {
                        "name": "your-first-provider",
                        "type": "www",
                        "config": {
                            "basic": {
                                "username": "your-username",
                                "password": "your-password"
                            }
                        }
                    },
                    {
                        "name": "your-second-provider",
                        "type": "www",
                        "config": {
                            "bearer": "your-bearer-token"
                        }
                    }
                ]
            }
        }
    }

Una respuesta no satisfactoria contiene un mensaje de error. Para obtener más información sobre errores, consulta Códigos de error y de estado.

Actualización

Para configurar los proveedores del cliente de la API de WhatsApp Business, usa el extremo /v1/settings/application/media/providers con la información del proveedor. Por el momento, solo es posible configurar un proveedor por vez. Además, solo puedes usar estos objetos de proveedor para enviar mensajes con contenido multimedia mediante enlaces HTTP/HTTPS que recurren a la autenticación básica o a la autenticación por token del portador.

Ejemplo

Los siguientes ejemplos muestran cómo agregar un proveedor WWW (es decir, enlaces HTTP/HTTPS) con autorización básica y un proveedor con autenticación por token del portador. Actualmente, solo se admiten estos formatos de proveedor.

POST /v1/settings/application/media/providers
[{
    "name": "your-first-provider",
    "type": "www",
    "config": {
        "basic": {
            "username": "your-username",
            "password": "your-password"
        }
    }
 }
]
POST /v1/settings/application/media/providers
[{
    "name": "your-second-provider",
    "type": "www",
    "config": {
        "bearer": "your-bearer-token"
    }
 }
]

Si la solicitud se realiza correctamente, se devuelven el código de estado HTTP 200 OK y null o {}.

Una respuesta no satisfactoria contiene un mensaje de error. Para obtener más información sobre errores, consulta Códigos de error y de estado.

Asegúrate de asignarle un nombre único a los proveedores, dado que, si se vuelve a utilizar un nombre, se sobrescribe la entrada anterior.

Parámetros

NombreDescripción

name

Obligatorio.

El nombre del proveedor

type

Obligatorio.

El tipo de proveedor

config

Obligatorio.

El objeto config

Eliminación

Al enviar una llamada a la API DELETE con el name de un proveedor al punto de conexión /v1/settings/application/media/providers, se elimina dicho proveedor de la lista.

Ejemplo

DELETE /v1/settings/application/media/providers/your-config-name

Si la solicitud se realiza correctamente, se devuelven el código de estado HTTP 200 OK y null o {}.

Una respuesta no satisfactoria contiene un mensaje de error. Para obtener más información sobre errores, consulta Códigos de error y de estado.