Ir para o conteúdo

SendFileByUpload#

O método é projetado para enviar um arquivo carregado através de um formulário (form-data). A mensagem será adicionada à fila de envio. A velocidade de envio das mensagens na fila é regulada pelo parâmetro Intervalo de envio de mensagens.

Arquivos de vídeo, áudio e imagens são enviados da mesma forma que no WhatsApp nativo, com a possibilidade de visualização e audição. Documentos são enviados da mesma maneira que no WhatsApp nativo. O tipo do arquivo enviado e a forma como ele é enviado são determinados pela extensão do arquivo. Uma descrição é adicionada apenas a imagens e vídeos.

O tamanho máximo dos arquivos enviados é de 100 MB.

Solicitação#

Para enviar um arquivo, você precisa fazer uma solicitação para o seguinte endereço:

POST https://api.green-api.com/waInstance{{idInstance}}/SendFileByUpload/{{apiTokenInstance}}

Para obter os parâmetros da solicitação idInstance e apiTokenInstance, consulte a seção Antes de começar.

Parâmetros da solicitação#

Parâmetro Tipo Obrigatório Descrição
chatId string Sim Identificador do chat
file file Sim Arquivo enviado
fileName string Não Nome do arquivo. Deve conter a extensão do arquivo
caption string Não Descrição abaixo do arquivo. A descrição é adicionada a vídeos e imagens.
quotedMessageId string Não Identificador da mensagem citada; se especificado, a mensagem será enviada citando a mensagem do chat especificada.

Exemplo do corpo da solicitação#

Exemplo de código em Python

import requests

url = "https://api.green-api.com/waInstance{{idInstance}}/sendFileByUpload/{{apiTokenInstance}}"

payload = {'chatId': '11001234567@c.us',
'caption': 'Descrição'}
files = [
  ('file', ('window.jpg', open('C:/window.jpg','rb'),'image/jpeg'))
]
headers= {}

response = requests.request("POST", url, headers = headers, data = payload, files = files)

print(response.text.encode('utf8'))

Resposta#

Campos da resposta#

Campo Tipo Descrição
idMessage string Identificador da mensagem enviada

Exemplo do corpo da resposta#

{
    "idMessage": "3EB0C767D097B7C7C030"
}

Erros SendFileByUpload#

Veja a lista de erros comuns a todos os métodos na seção Erros Padrão