Referência da APIMensagens
Envia uma mensagem de midia
Enfileira o envio de uma mensagem de midia. O arquivo deve estar acessivel em uma URL publica informada em mediaUrl. O envio e assincrono (resposta 202).
Authorization
bearerAuth AuthorizationBearer <token>
API key enviada como Authorization Bearer pzk_live_... ou pzk_test_...
In: header
Path Parameters
id*string
Identificador da instancia.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/instances/cm5x8a9k20001abc123def456/messages/media" \ -H "Content-Type: application/json" \ -d '{ "to": "5511999999999", "type": "image", "mediaUrl": "https://exemplo.com/arquivo.jpg", "caption": "Mensagem de teste" }'{
"queued": true,
"to": "5511999999999",
"type": "image"
}{
"error": {
"code": "BAD_REQUEST",
"message": "Body invalido"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key ausente ou invalida"
}
}{
"error": {
"code": "PAYMENT_REQUIRED",
"message": "E necessario um plano ativo para usar este recurso. Assine em \"Meu plano\"."
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Projeto inativo ou sem permissao"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Instancia nao encontrada"
}
}{
"error": {
"code": "CONFLICT",
"message": "limite de numeros do plano atingido — adicione um numero em \"Meu plano\""
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "limite diario do sandbox (100 mensagens/dia) atingido. Para volume real, use o ambiente de producao com um plano ativo."
}
}