Chats tools
Read conversations, reply inside the 24-hour window, open or close threads, and keep private team notes customers never see.
waca_inbox_counts#What is waiting in the inbox
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
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"querystring
Contact name or phone.tag_idstring
No extra notes.assignee_account_idstring
No extra notes.cursorstring
No extra notes.page_sizeinteger
Rows per page, 1-100. Default 20.Default20response_format"concise" | "detailed"
concisereturns the fields a person reads;detailedadds ids and raw fields for follow-up calls.Default"concise"
waca_inbox_get_conversation#Get one conversation
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_idrequiredstring
No extra notes.
waca_inbox_list_messages#Read a conversation's messages
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_idrequiredstring
No extra notes.cursorstring
No extra notes.page_sizeinteger
Rows per page, 1-100. Default 20.Default20
waca_inbox_set_state#Assign, claim, release, close, reopen or mark read
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_idrequiredstring
No extra notes.actionrequired"assign" | "claim" | "release" | "close" | "reopen" | "mark_read"
No extra notes.assignee_account_idstring
No extra notes.
waca_inbox_reply#Reply to a conversation with text
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_idrequiredstring
No extra notes.textrequiredstring
No extra notes.
waca_inbox_reply_template#Reply to a conversation with a template
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_idrequiredstring
No extra notes.template_namerequiredstring
No extra notes.languagerequiredstring
No extra notes.variablesstring[]
No extra notes.Default[]
waca_notes_list#List internal notes
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_idstring
An inbox thread. Give this or contact_id.contact_idstring
A CRM contact. Give this or conversation_id.
waca_notes_add#Add an internal note
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_idstring
An inbox thread. Give this or contact_id.contact_idstring
A CRM contact. Give this or conversation_id.bodyrequiredstring
No extra notes.