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