> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wappfy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Enviar Status de Texto
> Enviar status de texto (story) com texto personalizado e cor de fundo
## Descrição
Este endpoint permite enviar um status de texto (story) no WhatsApp. Você pode personalizar o texto, cor de fundo e fonte, além de definir quais contatos poderão visualizar o status.
## Parâmetros de URL
ID único da sessão autenticada
## Corpo da Requisição
Texto a ser exibido no status
Cor de fundo em formato hexadecimal (ex: "#FF5733")
Número representando a fonte do texto
Array de JIDs dos contatos que poderão visualizar o status. Se não informado, o status será visível para todos os contatos.
Formato do JID: `["5511999999999@s.whatsapp.net"]`
```json Exemplo Completo theme={null}
{
"text": "Olá! Esta é minha história do dia!",
"backgroundColor": "#FF5733",
"font": 1,
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
```
```json Exemplo Simples (todos os contatos) theme={null}
{
"text": "Bom dia a todos!"
}
```
## Resposta
Indica se o status foi enviado com sucesso
ID da mensagem de status enviada
```json Resposta de Sucesso theme={null}
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
```
## Códigos de Status
* `200` - Status enviado com sucesso
* `400` - Parâmetros inválidos
* `401` - Não autorizado
* `500` - Erro no servidor
## Exemplo de Uso
```bash cURL theme={null}
curl -X POST https://api.wappfy.com.br/api/my-session/status/text \
-H "Content-Type: application/json" \
-d '{
"text": "Olá! Esta é minha história do dia!",
"backgroundColor": "#FF5733",
"font": 1
}'
```
```javascript JavaScript theme={null}
const session = 'my-session';
const response = await fetch(`https://api.wappfy.com.br/api/${session}/status/text`, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
text: 'Olá! Esta é minha história do dia!',
backgroundColor: '#FF5733',
font: 1,
participants: ['5511999999999@s.whatsapp.net']
})
});
const data = await response.json();
console.log(data);
```
```python Python theme={null}
import requests
session = 'my-session'
payload = {
'text': 'Olá! Esta é minha história do dia!',
'backgroundColor': '#FF5733',
'font': 1,
'participants': ['5511999999999@s.whatsapp.net']
}
response = requests.post(
f'https://api.wappfy.com.br/api/{session}/status/text',
json=payload
)
data = response.json()
print(data)
```
## Notas
* Status são conteúdos temporários (Stories) que desaparecem após 24 horas
* Se o parâmetro `participants` não for informado, o status será visível para todos os contatos
* A cor de fundo deve ser fornecida em formato hexadecimal (ex: "#FF5733")
* O campo `font` aceita números que representam diferentes estilos de fonte disponíveis no WhatsApp
## OpenAPI
````yaml viewer.json post /api/{session}/status/text
openapi: 3.1.0
info:
title: Wappfy - WhatsApp HTTP API
version: '2.0'
contact: {}
servers:
- url: https://{host}
description: Servidor Customizável
variables:
host:
default: api.wappfy.com.br
description: 'URL do servidor (ex: api.wappfy.com.br ou seu-servidor.com)'
security:
- api_key: []
tags:
- name: 🖥️ Sessions
description: >-
Controlar sessões do WhatsApp (contas) (Control WhatsApp sessions
(accounts))
- name: 🔑 Auth
description: Autenticação
- name: 🆔 Profile
description: Informações do seu perfil
- name: 🖼️ Screenshot
description: Obter captura de tela do WhatsApp e mostrar código QR
- name: 📤 Chatting
description: Métodos de conversação
- name: 📢 Channels
description: Métodos de canais (newsletters) (Channels (newsletters) methods)
- name: 🟢 Status
description: Métodos de status (aka stories) (Status (aka stories) methods)
- name: 💬 Chats
description: Métodos de conversas
- name: 👤 Contacts
description: >-
Métodos de contatos. Use número de telefone (sem +) ou número de telefone
e `@c.us` no final como `contactId`. Ex: `12312312310` OU
`12312312310@c.us` (Contacts methods.
Use phone number (without +) or phone number and `@c.us` at the end as `contactId`.
'E.g: `12312312310` OR `12312312310@c.us`
)
- name: 👥 Groups
description: Métodos de grupos (Groups methods).
- name: ✅ Presence
description: Informações de presença
- name: 📅 Events
description: Mensagem de Evento
- name: 🏷️ Labels
description: Etiquetas - disponível apenas para contas WhatsApp Business
- name: 🔍 Observability
description: Outros métodos
- name: 🗄️ Storage
description: Métodos de armazenamento
externalDocs:
description: Wappfy - WhatsApp HTTP API
url: https://wappfy.com.br/
paths:
/api/{session}/status/text:
post:
tags:
- 🟢 Status
summary: Enviar status de texto
description: O parâmetro {session} deve ser o instanceName da sessão.
operationId: StatusController_sendTextStatus
parameters:
- name: session
required: true
in: path
description: Nome da sessão (instanceName)
example: my-session
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TextStatus'
responses:
'201':
description: ''
security:
- api_key: []
components:
schemas:
TextStatus:
type: object
properties:
id:
type: string
description: Pre-generated status message id
example: BBBBBBBBBBBBBBBBB
default: null
contacts:
description: Contact list to send the status to.
example: null
type: array
items:
type: string
text:
type: string
default: Have a look! https://github.com/
backgroundColor:
type: string
default: '#38b42f'
font:
type: number
default: 0
linkPreview:
type: boolean
default: true
linkPreviewHighQuality:
type: boolean
default: false
required:
- text
- backgroundColor
- font
securitySchemes:
api_key:
type: apiKey
in: header
name: apikey
description: Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)
````