Skip to main content
Use chats to list conversations and apply actions such as archive, mute, pin, and expiration. For instances, see Instances and billing. For session, see Session.

Chats

client.chats.list(...)

chats = client.chats.list(
    instance_id="VZ...",
    instance_token="instance-token",
    page=1,
    page_size=20,
)
Return: page { page, page_size, total, total_pages, content[] } with chat metadata per item.

client.chats.get(...)

chat = client.chats.get(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Return: InstanceChatMetadataphone, jid, name, flags (archived, pinned, muted, etc.) and last message when available.

client.chats.archive(...)

client.chats.archive(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Return: { status: "ok" }.

client.chats.unarchive(...)

client.chats.unarchive(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Return: { status: "ok" }.

client.chats.mute(...)

client.chats.mute(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    duration_seconds=3600,
)
Return: { status: "ok" }.

client.chats.unmute(...)

client.chats.unmute(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Return: { status: "ok" }.

client.chats.pin(...)

client.chats.pin(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Return: { status: "ok" }.

client.chats.unpin(...)

client.chats.unpin(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Return: { status: "ok" }.

client.chats.read(...)

client.chats.read(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Return: { status: "ok" }.

client.chats.unread(...)

client.chats.unread(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
Return: { status: "ok" }.

client.chats.clear(...)

client.chats.clear(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    delete_media=False,
)
Return: { status: "ok" }.

client.chats.delete(...)

client.chats.delete(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    delete_media=False,
)
Return: { status: "ok" }.

client.chats.set_expiration(...)

client.chats.set_expiration(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    expiration="7_DAYS",
)
Return: { status: "ok" }. Accepted values for expiration: 24_HOURS, 7_DAYS, 90_DAYS, OFF.