Pular para o conteúdo principal

Enviar texto/url de status/Stories

Instruções:

Substitua o conteúdo existente entre [ ] pelo que corresponder ao seu cenário ou necessidade.

MétodoEndpoint
POST[baseUrl]/message/sendStatus/[instance]

Envie um Status/Stories de texto ou URL (clicável) para um, alguns ou todos os contatos em sua lista.

Dados a serem enviados na Requisição

{
"statusMessage": {
"type": "text",
"content": "Olá, como você está hoje? 😉👍\n\nVeja mais em\n\nhttps://evolution-api.com/",
"backgroundColor": "#008000",
"font": 1,
"allContacts": false,
"statusJidList": ["[remoteJid]@s.whatsapp.net"]
}
}

Dados retornados da Solicitação

{
"key": {
"remoteJid": "status@broadcast",
"fromMe": true,
"id": "BAE59F76997142F0"
},
"message": {
"extendedTextMessage": {
"text": "Olá, como você está hoje? 😉👍\n\nVeja mais em\n\nhttps://evolution-api.com/",
"matchedText": "https://evolution-api.com/",
"canonicalUrl": "https://evolution-api.com/opensource-whatsapp-api/",
"title": "OpenSource WhatsApp API – Evolution API",
"backgroundArgb": 4278222848,
"font": "SERIF",
"previewType": "NONE",
"thumbnailDirectPath": "/o1/v/t62.7118-24/f1/m230/up-oil-image-bae65e3e-9813-4686-99a5-53ab5e2336c7?ccb=9-4&oh=01_AdRENApzu4pB-Y6VDbbGWfD6w91B1rmxgveUJH_cCmt0Hg&oe=64DCEF1B",
"thumbnailSha256": "QcKPDG2Bk+d3fPceiuS1cnGuBNgv/8hHM4UgcwYMtKk=",
"thumbnailEncSha256": "UpEq8UfeJuT2/0A2nS7vEEIUZzIi+SmOydvvWQthzAs=",
"mediaKey": "KXuIeKYSqsHVD8uxEoHnQPjXuADqTVCtfuI35zbmVxc=",
"mediaKeyTimestamp": "1689621677",
"thumbnailHeight": 0,
"thumbnailWidth": 0
}
},
"messageTimestamp": "1689621677",
"status": "PENDING",
"participant": "[sender]@s.whatsapp.net"
}

Explicação dos parâmetros

ParameterTypeDescrição
statusMessage.typeObrigatórioInforme "text" para enviar mensagens de texto ou "url" para URLs clicáveis.
statusMessage.contentObrigatórioInforme o texto da mensagem que deseja enviar, podendo usar os mesmos recursos que você usaria no aplicativo ou na web, que são:

- Emojis
- Negrito, insira *seutexto*
- Itálico, entre _seutexto_
- Riscado, insira ~seutexto~
- Monoespaçado entre ```seutexto```

Para quebrar uma linha, insira "\n" na mensagem.

Confira o exemplo no payload para melhor entendimento.
statusMessage.backgroundColorObrigatórioInsira a cor desejada para o fundo do status/stories, usando o Código de Cor Hexadecimal.

Exemplos:

#FFFFFF = Branco
#0000FF = Azul
#008000 = Verde
#FFFF00 = Amarelo
#FF0000 = Vermelho
#800080 = Roxo
#808080 = Cinza
#FFC0CB = Rosa
statusMessage.fontObrigatórioEscolha o tipo de fonte a ser usado.

Aceite as opções abaixo:

1 = SERIF
2 = NORICAN_REGULAR
3 = BRYNDAN_WRITE
4 = BEBASNEUE_REGULAR
5 = OSWALD_HEAVY
statusMessage.allContactsObrigatórioPara enviar para TODOS os contatos, digite "true".

Os valores aceitos são "true" ou "false".

Se "false" for informado, "statusJidList" se torna obrigatório.
statusMessage.statusJidListOpcionalInsira o remoteJid de um ou mais contatos aos quais você deseja enviar status/stories.

remoteJid = Número no formato DDI + DDD + formato de número, com ou sem o final @s.whatsapp.net.

Ex: 5511911111111 ou 5511911111111@s.whatsapp.net

Se você deseja enviar para mais de um contato, apenas separe-os por vírgulas, como mostrado no exemplo abaixo:

551191111111,
5511922222222,
5511933333333
Nota:

Toda mensagem enviada pela Evolution API inicialmente tem o status PENDENTE.

Isso indica que o envio foi bem-sucedido e a mensagem está aguardando os seguintes status, que serão enviados para o Webhook MESSAGES_UPDATE.

Atenção:

É extremamente necessário que o payload obedeça às regras para criar um arquivo JSON, considerando o arranjo correto de itens, formatação, colchetes, chaves e vírgulas, etc.

Antes de consumir o endpoint, se você tiver dúvidas sobre a formatação JSON, vá para https://jsonlint.com/ e valide.