Ir para o conteúdo

SendFileByUrl#

O método é destinado para enviar um arquivo, carregado através de um link. A mensagem será adicionada à fila para envio. A mensagem para envio é armazenada por 24 horas na fila e será enviada assim que o telefone for autorizado. A velocidade de envio das mensagens da fila é regulada pelo parâmetro Intervalo de envio de mensagens.

Os arquivos de vídeo, áudio e imagens são enviados como no WhatsApp nativo, com a possibilidade de visualização e audição. Os documentos são enviados da mesma forma que no WhatsApp nativo. O tipo do arquivo enviado e a maneira como ele é enviado são determinados pela extensão do arquivo. A 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, é necessário fazer uma solicitação para o seguinte endereço:

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

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

Parâmetros de solicitação#

Parâmetro Tipo Obrigatório Descrição
chatId string Sim Identificador do chat
urlFile string Sim Link para o arquivo enviado
fileName string Sim Nome do arquivo. Deve conter a extensão do arquivo
caption string Não Descrição sob o arquivo. A descrição é adicionada a vídeos e imagens
quotedMessageId string Não Identificador da mensagem citada; se fornecido, a mensagem será enviada com a citação da mensagem do chat especificada
archiveChat boolean Não Arquiva o chat no qual a mensagem é enviada. Aceita valores: verdadeiro

Exemplo do corpo da solicitação#

Enviando uma mensagem para o chat privado:

{
    "chatId": "11001234567@c.us",
    "urlFile": "https://my.site.com/img/horse.png",
    "fileName": "horse.png",
    "caption": "Cavalinho"
}

Envio de mensagem para o chat em grupo:

{
    "chatId": "120363043968066561@g.us",
    "urlFile": "https://my.site.com/img/horse.png",
    "fileName": "horse.png",
    "caption": "Cavalinho"
}

Envio de mensagem com citação:

{
    "chatId": "11001234567@с.us",
    "urlFile": "https://my.site.com/img/horse.png",
    "fileName": "horse.png",
    "caption": "Cavalo",
    "quotedMessageId": "361B0E63F2FDF95903B6A9C9A102F34B"
}

Resposta#

Campos de resposta#

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

Exemplo do corpo da resposta#

{
    "idMessage": "3EB0C767D097B7C7C030"
}

Erros SendFileByUrl#

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

Exemplo de código em Python#

import requests

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

payload = "{\r\n   \t\"chatId\": \"11001234567@c.us\",\r\n\t\"urlFile\": \"https://avatars.mds.yandex.net/get-pdb/477388/77f64197-87d2-42cf-9305-14f49c65f1da/s375\",\r\n\t\"fileName\": \"horse.png\",\r\n\t\"caption\": \"cavalo\"\r\n}"
headers = {
  'Content-Type': 'application/json'
}

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

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