Fornecedores de mídia

/v1/settings/application/media/providers

Use o ponto de extremidade /v1/settings/application/media/providers e compile uma lista de fornecedores para enviar links de mídia. Ao usar uma lista, você pode contar com vários fornecedores de mídia do mesmo tipo e selecionar um fornecedor com base em cada solicitação.

Recuperação

Use a solicitação de API a seguir para recuperar a lista de fornecedores.

Exemplo

GET /v1/settings/application/media/providers

Caso a operação seja bem-sucedida, a resposta incluirá a lista de fornecedores:

"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"
                        }
                    }
                ]
            }
        }
    }

Uma resposta com falha conterá uma mensagem de erro. Consulte Mensagens de erro e status para obter mais informações sobre erros.

Atualização

Se quiser configurar fornecedores para o cliente da WhatsApp Business API, use o ponto de extremidade /v1/settings/application/media/providers com as informações do fornecedor. No momento, você só pode configurar um fornecedor por vez. Além disso, só é possível usar esses objetos de fornecedor para enviar mensagens de mídia com links HTTP/HTTPS que se baseiam em autenticação básica ou de token de portador.

Exemplo

Os exemplos abaixo mostram como adicionar um fornecedor WWW (links HTTP/HTTPS) com autorização básica e um fornecedor com autenticação de token de portador. No momento, esses são os únicos formatos de fornecedor compatíveis.

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"
    }
 }
]

Se for bem-sucedida, a solicitação retornará o código de status HTTP 200 OK, bem como null ou {}.

Uma resposta com falha conterá uma mensagem de erro. Consulte Mensagens de erro e status para obter mais informações sobre erros.

Lembre-se de dar um nome único para cada fornecedor. Se você reutilizar um nome, a entrada anterior será substituída.

Parâmetros

NomeDescrição

name

Obrigatório.

O nome do fornecedor.

type

Obrigatório.

O tipo de fornecedor.

config

Obrigatório.

O objeto config.

Exclusão

Para excluir um fornecedor da lista, envie uma chamada de API DELETE com o name do fornecedor em questão ao ponto de extremidade /v1/settings/application/media/providers.

Exemplo

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

Se for bem-sucedida, a solicitação retornará o código de status HTTP 200 OK, bem como null ou {}.

Uma resposta com falha conterá uma mensagem de erro. Consulte Mensagens de erro e status para obter mais informações sobre erros.