Pular para o conteúdo principal
POST
Atualizar uma conversa

Autorizações

Authorization
string
header
obrigatório

Autentique com uma chave secreta (sk_live_…) ou uma chave restrita (rk_live_…) criada no painel. Chaves restritas só têm as permissões escolhidas na criação, como messages:send, chats:read ou broadcasts:send.

Cabeçalhos

Idempotency-Key
string

Uma chave única, como um UUID, que torna seguro repetir esta requisição por 24 horas.

Maximum string length: 255
Blu-Version
string

A versão da API a usar. Por padrão, é a versão fixada na sua conta.

Exemplo:

"2026-10-11"

Parâmetros de caminho

chat
string
obrigatório
Pattern: ^chat_

Corpo

application/json
metadata
object

Até 50 pares de chave e valor seus. Chaves com até 40 caracteres e valores com até 500.

Resposta

A conversa atualizada.

id
string
obrigatório
Pattern: ^chat_
Exemplo:

"chat_Q8x2"

object
string
obrigatório
Allowed value: "chat"
phone_number
obrigatório

O seu número nesta conversa. Expansível.

Pattern: ^pn_
wa_id
string
obrigatório

A outra parte. Ids de grupo terminam em @g.us.

Exemplo:

"5511988887777"

type
enum<string>
obrigatório
Opções disponíveis:
individual,
group
name
string | null
obrigatório

O nome do contato, o nome de perfil no WhatsApp ou o assunto do grupo.

contact
obrigatório

O contato deste wa_id. Nulo em grupos. Expansível.

Pattern: ^cont_
last_message_at
integer | null
obrigatório
service_window_expires_at
integer | null
obrigatório

Quando mensagens livres deixam de ser permitidas, 24 horas após a última mensagem do contato. Nulo quando a janela está fechada.

created
integer
obrigatório

Horário Unix em segundos.

Exemplo:

1760190012

metadata
object
obrigatório

Até 50 pares de chave e valor seus. Chaves com até 40 caracteres e valores com até 500.