Chats
9 tools

Chats tools

Read conversations, reply inside the 24-hour window, open or close threads, and keep private team notes customers never see.

Badges:Read onlyWrites dataSends to WhatsAppDestructive
waca_inbox_counts#

What is waiting in the inbox

Read only

Counts of unassigned, mine, open, closed and unread conversations. The quickest way to see whether anything needs attention.

Takes no parameters.

waca_inbox_list_conversations#

List inbox conversations

Read only

WhatsApp threads with the contact name, phone, unread count, who holds it, the last message preview and whether the free-text reply window is open. view picks the queue: unassigned, mine (held by this key's owner), all, closed or unread. Page with cursor.

Parameters (7)›
  • view

    "unassigned" | "mine" | "all" | "closed" | "unread"

    No extra notes.Default "all"
  • query

    string

    Contact name or phone.
  • tag_id

    string

    No extra notes.
  • assignee_account_id

    string

    No extra notes.
  • cursor

    string

    No extra notes.
  • page_size

    integer

    Rows per page, 1-100. Default 20.Default 20
  • response_format

    "concise" | "detailed"

    concise returns the fields a person reads; detailed adds ids and raw fields for follow-up calls.Default "concise"
waca_inbox_get_conversation#

Get one conversation

Read only

One thread's header: contact, state, assignee, unread count, tags and reply-window state. Read the messages with waca_inbox_list_messages.

Parameters (1)›
  • conversation_idrequired

    string

    No extra notes.
waca_inbox_list_messages#

Read a conversation's messages

Read only

Messages of one thread, oldest to newest within the page, with direction, text, type, status and who sent it. Page backwards in time with cursor.

Parameters (3)›
  • conversation_idrequired

    string

    No extra notes.
  • cursor

    string

    No extra notes.
  • page_size

    integer

    Rows per page, 1-100. Default 20.Default 20
waca_inbox_set_state#

Assign, claim, release, close, reopen or mark read

Writes data

Changes a thread's state. assign needs assignee_account_id (from waca_workspace_members_list). claim takes the thread for this key's owner; release gives it back to the unassigned queue; close ends it; reopen brings a closed thread back; mark_read clears the unread count.

Parameters (3)›
  • conversation_idrequired

    string

    No extra notes.
  • actionrequired

    "assign" | "claim" | "release" | "close" | "reopen" | "mark_read"

    No extra notes.
  • assignee_account_id

    string

    No extra notes.
waca_inbox_reply#

Reply to a conversation with text

Sends to WhatsApp

Sends a free-text WhatsApp reply on a thread. Only works while the 24-hour reply window is open (reply_window_open on the conversation); otherwise use waca_inbox_reply_template. Claims an unassigned thread for this key's owner. Reaches a real phone.

Parameters (2)›
  • conversation_idrequired

    string

    No extra notes.
  • textrequired

    string

    No extra notes.
waca_inbox_reply_template#

Reply to a conversation with a template

Sends to WhatsApp

Sends an APPROVED template on a thread, which is the only way to reach the customer after the 24-hour window closes. variables fill the body placeholders in order (check with waca_templates_get). Claims an unassigned thread. Reaches a real phone and is billed.

Parameters (4)›
  • conversation_idrequired

    string

    No extra notes.
  • template_namerequired

    string

    No extra notes.
  • languagerequired

    string

    No extra notes.
  • variables

    string[]

    No extra notes.Default []
waca_notes_list#

List internal notes

Read only

Private team notes on an inbox thread or a CRM contact. Notes are never sent to the customer. A thread's list also includes notes written on its contact.

Parameters (2)›
  • conversation_id

    string

    An inbox thread. Give this or contact_id.
  • contact_id

    string

    A CRM contact. Give this or conversation_id.
waca_notes_add#

Add an internal note

Writes data

Writes a private note on an inbox thread or a CRM contact for the team to read. The customer never sees it. Good for summaries, hand-over context and follow-up reminders.

Parameters (3)›
  • conversation_id

    string

    An inbox thread. Give this or contact_id.
  • contact_id

    string

    A CRM contact. Give this or conversation_id.
  • bodyrequired

    string

    No extra notes.