Wati connects to a Nagent workspace with an API key. Once it is connected, agents can call 5 Wati actions, such as "Add Contact", "Get Teams" and "Send Session Message". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Wati, with input parameters and output schema.
WATI_ADD_CONTACTTool to add a new contact in WATI. Use when registering a customer's WhatsApp number before sending messages.
Input parameters
Display name of the contact, e.g., 'Alice Johnson'.
List of custom key/value attributes for the contact.
WhatsApp number including country code, digits only (no '+' or spaces), length 6-15.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
WATI_GET_TEAMSTool to retrieve a list of teams from WATI. Use after authenticating when you need to enumerate all available teams.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
WATI_SEND_SESSION_MESSAGETool to send a session message to a specified WhatsApp number. Use when you need to deliver a free-form text within an active 24-hour session window.
Input parameters
The text of the message to be sent in the active session.
Recipient's WhatsApp number with country code (digits only, without '+' or spaces). Example: 85264318721
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
WATI_UPDATE_CHAT_STATUSUpdate the status of a chat/conversation in WATI Team Inbox. This action allows you to change the status of a customer's chat to help manage ongoing conversations. Available statuses: - OPEN: Active, two-way conversation - PENDING: Waiting for customer's response - SOLVED: Issue has been resolved - BLOCK: Prevent further communication with the contact
Input parameters
The status to set for the chat. Allowed values: OPEN (active conversation), SOLVED (issue resolved), PENDING (waiting for customer response), BLOCK (prevent further communication).
The customer's WhatsApp phone number (e.g., '1234567890'). Must include country code without '+' or spaces.
The business channel phone number. Required for accounts with multiple WhatsApp numbers. Must include country code without '+' or spaces.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
WATI_UPDATE_CONTACT_ATTRIBUTESTool to update attributes of an existing contact. Use after confirming the contact exists and you need to modify its custom attributes.
Input parameters
Optional list of custom attributes to update for the contact. Each item should include a name and value.
Target contact's WhatsApp number in international format with '+' and country code.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 5 Wati actions on Nagent, including "Add Contact", "Get Teams" and "Send Session Message". Add Contact: Add a new contact in WATI. Each action is listed on this page with its input parameters and its output.
Wati connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Add Contact takes 1 required input: whatsappNumber. It also takes 2 optional inputs: name and customParams. It returns data, error and successful.