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'))