Resolve a user_ns from a phone number or a channel user_id.

Pass exactly one of phone (Ecuador +593 normalization applied) or user_id (a channel-native id such as a WhatsApp wa_id). Read-only. If several contacts match a phone it returns them all and leaves user_ns None rather than guessing.

Return the full profile for one contact. user_ns from find_contact or list_contacts. Read-only.

Search contacts by phone / name / email / tag_ns, paginated. tag_ns from list_tags. Read-only.

List the custom contact-field definitions (optionally filtered by name). Use to get exact field_name values for set_contact_field. Read-only.

List the account's tags (optionally filtered by name). Provides tag_ns and exact tag names for the tag/broadcast tools. Read-only.

Set a custom field on one contact. user_ns from find_contact; field_name from list_contact_fields. Write: overwrites the stored value.

Add a tag to one contact. user_ns from find_contact; tag_name from list_tags. Write: changes contact segmentation and can trigger automations.

Remove a tag from one contact. user_ns from find_contact; tag_name from list_tags. Write: changes contact segmentation.

Move a contact's chat to open, pending, spam, or done. user_ns from find_contact. Write: visible to agents in the Chatea Pro inbox.

Assign a contact's chat to a human agent. user_ns from find_contact; agent_id from list_agents. Write: reroutes the conversation.

Assign a contact's chat to an agent group. user_ns from find_contact; agent_group_id from list_agent_groups. Write: reroutes the conversation.

Clear the human-agent assignment on a contact's chat. user_ns from find_contact. Write: reroutes the conversation.

Pause the bot for one contact for minutes (must be positive). user_ns from find_contact. Write: automations stop replying to this contact.

Resume the bot for one contact after pause_bot. user_ns from find_contact. Write: automations start replying again.

List published sub-flows (optionally filtered by name). Provides the exact flow_name for trigger_flow. Read-only.

List approved WhatsApp message templates (optionally filtered by name). Provides namespace, name, lang, and params for the template tools. Read-only.

Send a contact into a sub-flow. user_ns from find_contact; flow_name from list_flows. Write: customer-visible; may send WhatsApp messages.

Send a free-text message to one contact. user_ns from find_contact. Write: irreversible; delivers a real WhatsApp message to the customer. Only works inside the 24h customer-service window.

Send an approved WhatsApp template to one contact. user_ns from find_contact; namespace/name/lang/params from list_whatsapp_templates. Write: irreversible; delivers a real WhatsApp message to the customer.

List shop orders, paginated; pass user_ns (from find_contact) to scope to one contact. Read-only.

Return full detail for one order. order_id from list_orders. Read-only.

List team agents (optionally filtered by name/role). Provides agent_id for assign_agent. Read-only.

List agent groups (optionally filtered by name). Provides agent_group_id for assign_agent_group. Read-only.

List ticket lists / boards (optionally filtered by name). Provides list_id for get_ticket_list_items. Read-only.

List items in one ticket list, paginated; optionally filter by user_ns (from find_contact) or title. list_id from list_ticket_lists. Read-only.