Ir para o conteúdo

SendMessage#

O método tem como finalidade enviar mensagens de texto para um chat pessoal ou em grupo. 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 texto, é necessário fazer uma solicitação para o seguinte endereço:

POST https://api.green-api.com/waInstance{{idInstance}}/SendMessage/{{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
message string Sim Texto da mensagem. Suporta emojis 😃
quotedMessageId string Não Identificador da mensagem citada. Se especificado, a mensagem será enviada com citação da mensagem especificada no chat.
archiveChat boolean Não Move o chat para o arquivo após o envio da mensagem. Aceita os valores: true
linkPreview boolean Não Parâmetro que ativa a exibição de pré-visualização e descrição de links. Ativado por padrão. Aceita os valores: true/false

O comprimento máximo da mensagem de texto é 10000 caracteres

Exemplo de Corpo de Solicitação#

Enviando uma mensagem para um chat pessoal:

{
    "chatId": "11001234567@c.us",
    "message": "I use Green-API to send this message to you!"
}

Envio de mensagem para um chat em grupo:

{
    "chatId": "120363043968066561@g.us",
    "message": "I use Green-API to send this message to you!"
}

Envio de mensagem com citação:

{
    "chatId": "11001234567@с.us",
    "message": "I use Green-API to send this message to you!",
    "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 SendMessage#

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}}/sendMessage/{{apiTokenInstance}}"

payload = "{\r\n\t\"chatId\": \"11001234567@c.us\",\r\n\t\"message\": \"I use Green-API to send this message to you!\"\r\n}"
headers = {
  'Content-Type': 'application/json'
}

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

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