manage_conversation
Manage Conversation
Open or close a conversation for a contact. When closing, you can optionally provide a category and summary for the closing note.
manage_conversation
Open or close a conversation for a contact. When closing, you can optionally provide a category and summary for the closing note.
get_contact
Retrieve a contact by identifier (ID, phone, or email). Returns the full contact profile including tags, assignee, custom fields, and channel information.
list_message_templates
List available message templates for a connected channel (e.g. WhatsApp templates). Use this to discover template names and parameters before sending template messages.
send_template_message
Send a template message (e.g. WhatsApp template) to a contact. Templates must be pre-approved on the channel. Use the List Message Templates tool to find available templates and their required parameters.
update_contact
Update an existing contact's profile fields. Identify the contact by ID, phone, or email, then provide any fields to update including name, phone, email, language, country code, and custom fields.
assign_conversation
Assign or unassign a user (agent) to a contact's conversation. To unassign, omit the assigneeId. Use the List Workspace Users tool to find available user IDs.
merge_contacts
Merge two contacts into one. The primary contact is retained and the secondary contact's data is merged into it. The secondary contact is removed after the merge.
create_contact
Create a new contact in the Respond.io workspace. Specify the contact using an identifier (phone or email) along with profile fields like name, language, and country code. Custom fields can also be set.
send_message
Send a message to a contact through a connected channel. Supports text messages, media/attachments (image, video, audio, file), and custom payloads. If no channel is specified, the message is sent through the last interacted channel.
list_messages
Retrieve the message history for a specific contact. Returns messages sent and received across all connected channels, with cursor-based pagination.
list_workspace_resources
List workspace resources such as connected channels or workspace users (agents). Use this to discover channel IDs for messaging or user IDs for conversation assignment.
list_custom_fields
List all custom fields defined in the workspace, or retrieve a specific custom field by ID. Custom fields store additional contact data used for personalization and workflows.
delete_contact
Permanently delete a contact from the Respond.io workspace by their contact ID. This action cannot be undone.
list_contacts
Search and list contacts in the workspace with optional filtering. Supports AND/OR filter conditions on any contact field. Results are paginated with cursor-based navigation.
manage_contact_tags
Add or remove tags on a specific contact. Tags are used for grouping and filtering contacts. You can add and remove tags in a single operation.
add_comment
Add an internal comment (note) to a contact's conversation. Comments are visible to workspace members and can mention users with the `{{@user.ID}}` syntax.
Manage omnichannel customer messaging across WhatsApp, Facebook Messenger, Telegram, Viber, email, and web chat. Create, update, search, merge, and delete contacts with custom fields and tags. Send text, media, attachment, and template messages to contacts through connected channels. Open and close conversations, assign and unassign agents to contacts. List message templates for connected channels. Configure custom channels via webhooks for unsupported messaging providers. Receive real-time webhook notifications for new messages, conversation events, contact changes, and comments.
Common questions about connecting Respondio to AI agents with Metorial.