LastIncomingMessages#

O método retorna as últimas mensagens recebidas da conta. Por padrão, são retornadas as mensagens dos últimos 24 horas.

Requisição#

Para obter as mensagens recebidas, é necessário fazer uma solicitação para o seguinte endereço:

GET https://api.green-api.com/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}?minutes={{minutes_count}}

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

Parâmetros da URL da requisição#

Parâmetro	Tipo	Obrigatório	Descrição
`minutes`	integer	não	tempo em minutos para exibir as mensagens (padrão: 1440 minutos)

Resposta#

Campos da resposta#

Matriz de objetos com os seguintes campos:

Campo	Tipo	Descrição
`idMessage`	string	Identificador da mensagem recebida
`timestamp`	integer	Horário em que a mensagem foi recebida no formato UNIX
`typeMessage`	string	Tipo de mensagem, com os valores possíveis:
		`textMessage` - mensagem de texto
		`imageMessage` - mensagem com imagem
		`videoMessage` - mensagem de vídeo
		`documentMessage` - mensagem com arquivo de documento
		`audioMessage` - mensagem de áudio
		`locationMessage` - mensagem de localização
		`contactMessage` - mensagem de contato
		`extendedTextMessage` - mensagem com link e pré-visualização
		`quotedMessage` - mensagem citada (OBSOLETO)
		`buttonsMessage` - mensagem com botões
		`templateMessage` - mensagem com botões de modelo
		`listMessage` - mensagem com botão de lista
		`buttonsResponseMessage` - resposta com botões
		`templateButtonsReplyMessage` - resposta com botões estilizados
		`listResponseMessage` - resposta com lista
`chatId`	string	Identificador da conversa em que a mensagem foi recebida
`senderId`	string	Identificador do remetente da mensagem
`senderName`	string	Nome do remetente da mensagem
`textMessage`	string	Texto da mensagem, se `typeMessage` = `textMessage`
`downloadUrl`	string	URL de download do arquivo, se `typeMessage` = `imageMessage`/`videoMessage`/`documentMessage`/`audioMessage`
`caption`	string	Descrição do arquivo
`location`	object	Objeto com informações sobre a localização
`contact`	object	Objeto com informações sobre o contato
`extendedTextMessage`	object	Objeto com mensagem de texto estendida (link)
`quotedMessage`	object	Objeto com informações da mensagem citada. Presente apenas se a mensagem em si for uma citação

Campos do objeto location:

Campo	Tipo	Descrição
`nameLocation`	string	Nome da localização
`address`	string	Endereço da localização
`latitude`	double	Latitude da localização
`longitude`	double	Longitude da localização
`jpegThumbnail`	string	Miniatura da imagem em codificação `base64`

Campos do objeto contact:

Campo	Tipo	Descrição
`displayName`	string	Nome exibido do contato
`vcard`	string	Estrutura VCard do contato

Campos do objeto extendedTextMessage:

Campo	Tipo	Descrição
`text`	string	Texto do link
`description`	string	Descrição do link
`title`	string	Título do link
`previewType`	string	Tipo de pré-visualização do link
`jpegThumbnail`	string	Miniatura da imagem em codificação `base64`
`stanzaId`	string	ID da mensagem citada
`participant`	string	ID da conversa do destinatário

Exemplo de corpo de resposta#

[
    {
        "idMessage": "DE8CFFA93B95237B077F8FA08331A0B5",
        "timestamp": 1587129319,
        "typeMessage": "textMessage",
        "chatId": "11001234567@c.us",
        "senderId": "11001234567@c.us",
        "senderName": "João",
        "textMessage": "Oi, tudo bem?"
    },
    {
        "idMessage": "EA0BD1AE042DC4F3609867126309D67C",
        "timestamp": 1587147598,
        "typeMessage": "imageMessage",
        "chatId": "11001234567@c.us",
        "senderId": "11001234567@c.us",
        "senderName": "Maria",
        "downloadUrl": "https://api.green-api.com/waInstance1234/downloadFile/EA1BD1AE042DC4F3609867126309D67C",
        "caption": "Olha essa foto!"
    },
    {
        "idMessage": "DE8CFFA93B95237B077F8FA08331A0B5",
        "timestamp": 1587129319,
        "typeMessage": "locationMessage",
        "chatId": "71234567891@c.us",
        "senderId": "1234567891@c.us",
        "senderName": "Pedro",
        "location": {
            "nameLocation": "Estou aqui, venha me ver",
            "address": "614111, Perm",
            "latitude": 53.9370129,
            "longitude": 54.8728409,
            "jpegThumbnail": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wB=="
        }
    },
    {
        "idMessage": "DE8CFFA93B95237B077F8FA08331A0B5",
        "timestamp": 1587129319,
        "typeMessage": "contactMessage",
        "chatId": "1234567891@c.us",
        "senderId": "71234567891@c.us",
        "senderName": "Lucas",
        "contact": {
            "displayName": "Ana Silva",
            "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:Silva;Ana;;;\nFN:Ana Silva\nORG:Image\nTITLE:\nitem1.TEL;waid=79099291652:+7 123 456-78-91\nitem1.X-ABLabel:Celular\nEND:VCARD"
        }
    },
    {
        "idMessage": "DE8CFFA93B95237B077F8FA08331A0B5",
        "timestamp": 1587129319,
        "typeMessage": "extendedTextMessage",
        "chatId": "1234567891@c.us",
        "senderId": "71234567891@c.us",
        "senderName": "Lucas",
        "extendedTextMessage": {
            "text": "https://www.youtube.com/watch?v=9lO06Zxhu8*8*",
            "description": "Vídeo interessante",
            "title": "Um ótimo vídeo",
            "previewType": "video",
            "jpegThumbnail": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wB=="
        }
    },
    {
        "idMessage": "6195B3523153621DFDFC184D3317E80D",
        "timestamp": 1603182280,
        "typeMessage": "quotedMessage",
        "chatId": "71234567891@c.us",
        "senderId": "71234567891@c.us",
        "senderName": "Marcela",
        "textMessage": "Essa é uma citação de teste",
        "extendedTextMessage": {
            "stanzaId": "3A6424373F90A939B3C8",
            "participant": "71987654321@c.us"
        }
    }
]

Erros em LastIncomingMessages#

Consulte a lista de erros comuns a todos os métodos na seção Erros Comuns

Exemplo de Código em Python#

import requests

url = "https://api.green-api.com/waInstance{{idInstance}}/lastIncomingMessages/{{apiTokenInstance}}?minutes=3240"

payload = {}
headers= {}

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

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