Contacts
The Contacts plugin manages Joomla’s Contacts component records and their categories through a simple conversation with your AI assistant.
These tools cover the Contacts component (com_contact). They are only offered to the assistant if this component is enabled on the site: it is often disabled by default, so enable it under System → Manage → Extensions if necessary. Every action requires access to the contact manager (core.manage), as in the administration area, in addition to the permission listed in the “Required permissions” column. As contacts have no permissions of their own, permissions are checked on their category.
Contacts
View and maintain contact records: position, email address, telephone numbers, address, website, free text, image and linked user account.
| Tool | Function | Required permissions (ACL) |
|---|---|---|
list_contacts | List and search contacts (filters by category, status, featured status, language and linked account) | Admin access — core.manage |
get_contact | Read a complete contact record, including its custom fields, tags and public address | Admin access — core.manage |
create_contact | Create a contact | Admin access + Create in the category — core.manage + core.create |
update_contact | Update a contact (only the fields provided are changed) | Admin access + Edit — core.manage + core.edit (or core.edit.own for its author) |
set_contact_state | Publish, unpublish, archive, move to the bin or feature | Admin access + Edit State — core.manage + core.edit.state |
delete_contacts | Permanently delete contacts moved to the bin | Admin access + Delete — core.manage + core.delete |
Custom field values (context com_contact.contact) are passed through the fields argument, using the field name. The contact form is enabled with contact_form, and the page displayed after submission is configured with redirect; the other display options (params) are merged with the existing settings without replacing them.
Categories
Organise contacts by category (team, department, agency...).
| Tool | Function | Required permissions (ACL) |
|---|---|---|
list_contact_categories | List contact categories, including the number of contacts | Admin access — core.manage |
create_contact_category | Create a contact category | Admin access + Create — core.manage + core.create |
Good to know
- A non-existent category is rejected: the assistant never creates a category by mistake. If no category is specified, the component's only published category is used when there is just one.
- Permanent deletion takes two steps: a preview first, followed by execution once you have given your approval. Only contacts in the bin can be deleted, just as in the administration interface.
- Creations, modifications, status changes and deletions appear in Joomla's action log.
- The assistant does not offer the option to send a message via the contact form.
Prompt examples
“Add our two new sales representatives to the Contacts page, with their telephone numbers and email addresses.”
“Enable the contact form on the customer service page and redirect to the Thank you page after submission.”