Ir para o conteúdo

SendLocation#

Este método destina-se a enviar uma mensagem de localização. A mensagem será enfileirada para envio. As mensagens enfileiradas para envio são armazenadas por 24 horas na fila e serão enviadas assim que o telefone for autorizado. A velocidade de envio das mensagens enfileiradas é controlada pelo parâmetro Intervalo de Envio de Mensagens.

Requisição#

Para enviar uma mensagem de localização, é necessário fazer uma solicitação para o seguinte endereço:

POST https://api.green-api.com/waInstance{{idInstance}}/sendLocation/{{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
nameLocation string Não Nome da localização
address string Não Endereço da localização
latitude double Sim Latitude da localização
longitude double Sim Longitude da localização
quotedMessageId string Não Identificador da mensagem citada. Se especificado, a mensagem será enviada com citação da mensagem especificada no chat.

Exemplo de Corpo de Solicitação#

Enviando uma mensagem para um chat pessoal:

{
    "chatId": "11001234567@c.us",
    "nameLocation": "Cristo Redentor",
    "address": "Parque Nacional da Tijuca, Rio de Janeiro",
    "latitude": -22.951873,
    "longitude": -43.210487
}

Отправка сообщения в групповой чат: 

{
    "chatId": "120363043968066561@g.us",
    "nameLocation": "Cristo Redentor",
    "address": "Parque Nacional da Tijuca, Rio de Janeiro",
    "latitude": -22.951873,
    "longitude": -43.210487
}

Отправка сообщения с цитированием: 

{
    "chatId": "11001234567@c.us",
    "nameLocation": "Cristo Redentor",
    "address": "Parque Nacional da Tijuca, Rio de Janeiro",
    "latitude": -22.951873,
    "longitude": -43.210487,
    "quotedMessageId": "361B0E63F2FDF95903B6A9C9A102F34B"
}

Resposta#

Campos da resposta#

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

Exemplo de corpo de resposta#

{
    "idMessage": "3EB0C767D097B7C7C030"
}

Erros em SendLocation#

Consulte a seção Erros Comuns para uma lista de erros que são comuns a todos os métodos.

Exemplo de código em Python#

import requests

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

payload = "{\r\n    \"chatId\": \"11001234567@c.us\",\r\n    \"nameLocation\": \"Estou Aqui, Venha Aqui\",\r\n    \"address\": \"Parque Nacional da Tijuca, Rio de Janeiro\",\r\n   \t\"latitude\": -22.951873,\r\n    \"longitude\": -43.210487\r\n}\r\n"
headers = {
  'Content-Type': 'application/json'
}

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

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