Contatos
O plugin Contatos gerencia os registros do componente Contatos do Joomla e suas categorias a partir de uma simples conversa com seu assistente de IA.
Estas ferramentas dizem respeito ao componente Contatos (com_contact). Elas só são disponibilizadas ao assistente se esse componente estiver ativado no site: muitas vezes ele vem desativado por padrão; se necessário, ative-o em Sistema → Gerenciar → Extensões. Toda ação exige acesso ao gerenciador de contatos (core.manage), assim como na administração, além da permissão indicada na coluna «Direitos necessários». Como os contatos não têm permissões próprias, as permissões são verificadas na categoria.
Contatos
Consultar e manter atualizados os cadastros de contato: cargo, e-mail, telefones, endereço, site, texto livre, imagem e conta de usuário vinculada.
| Ferramenta | Função | Direitos necessários (ACL) |
|---|---|---|
list_contacts | Listar e pesquisar contatos (filtros por categoria, estado, destaque, idioma e conta vinculada) | Acesso administrativo — core.manage |
get_contact | Ler um cadastro completo, com seus campos personalizados, tags e endereço público | Acesso administrativo — core.manage |
create_contact | Criar um contato | Acesso administrativo + Criar na categoria — core.manage + core.create |
update_contact | Editar um contato (somente os campos fornecidos são alterados) | Acesso administrativo + Editar — core.manage + core.edit (ou core.edit.own para o próprio autor) |
set_contact_state | Publicar, despublicar, arquivar, mover para a lixeira e marcar como destaque | Acesso administrativo + Editar estado — core.manage + core.edit.state |
delete_contacts | Excluir definitivamente contatos enviados para a lixeira | Acesso administrativo + Excluir — core.manage + core.delete |
Os valores dos campos personalizados (contexto com_contact.contact) são informados pelo argumento fields, usando o nome do campo. O formulário de contato é ativado com contact_form e a página exibida após o envio é definida com redirect; as outras opções de exibição (params) são mescladas às configurações existentes, sem apagá-las.
Categorias
Organize os contatos por categoria (equipe, departamento, agência…).
| Ferramenta | Função | Permissões necessárias (ACL) |
|---|---|---|
list_contact_categories | Listar as categorias de contatos, com o número de contatos | Acesso de administrador — core.manage |
create_contact_category | Criar uma categoria de contatos | Acesso de administrador + Criar — core.manage + core.create |
Bom saber
- Uma categoria inexistente é recusada: o assistente nunca cria uma categoria por engano. Se nenhuma categoria for especificada, a única categoria publicada do componente será usada, caso haja apenas uma.
- A exclusão definitiva ocorre em duas etapas: primeiro uma prévia, depois a execução após sua confirmação. Somente os contatos na lixeira podem ser excluídos, assim como na administração.
- Criações, alterações, mudanças de status e exclusões aparecem no registro de ações do Joomla.
- O envio de uma mensagem pelo formulário de contato não é oferecido ao assistente.
Exemplos de prompts
“Adicione nossos dois novos vendedores à página Contatos, com o telefone e o e-mail deles.”
“Ative o formulário de contato na página do atendimento ao cliente e redirecione para a página de agradecimento após o envio.”