Ferramentas · Comunidade e estrutura

O ponto de partida de toda conversa e a forma da comunidade: em que comunidade e com que papel o assistente está, quais seções e espaços existem, e criar, reordenar, ajustar ou excluir essa estrutura, inclusive quem vê cada espaço. É aqui também que o assistente entende um link que você cola na conversa, e que ele vê e muda as configurações da comunidade (nome, cores, logo, SEO, idioma e regras de entrada) e o e-mail que recebe os avisos de venda.

Cada ferramenta traz um selo: Só consulta não muda nada, Altera cria ou muda algo na hora, e Pede confirmação só age depois do seu sim a um resumo. Ver Dinheiro e confirmação.

#Em resumo

#get_community_context

Só consulta

Contexto da comunidade. O ponto de partida: diz em qual comunidade a conexão está, com qual papel, e lista as seções e os espaços com os ids. Papel mínimo: qualquer.

Parâmetros: nenhum.

Devolve: a comunidade (id, nome, endereço), você (papel e nome), os escopos da conexão (read, write), as seções (id, título, se é a inicial, visibilidade) com os espaços de cada uma (id, título, módulo, visibilidade), a ordem em que as coisas precisam ser criadas, e os ícones disponíveis para espaços (available_icons, com o uso de cada um).

Peça assim: "Em que comunidade você está conectado, e com que papel?" · "Quais espaços a comunidade tem?"

Notas: os assistentes costumam chamar esta ferramenta sozinhos no começo de cada conversa. A ordem de criação que ela devolve é a mesma de Ordem de criação.

#list_spaces

Só consulta

Listar seções e spaces. As seções e os espaços, com id, módulo e visibilidade, com filtro por módulo. Papel mínimo: qualquer; cada um vê o que pode ver.

Devolve: as seções com os espaços, como no get_community_context.

Peça assim: "Qual é o espaço de cursos?" · "Liste os espaços de eventos."

#open_link

Só consulta

Abrir link do app. Recebe um link da sua comunidade (ou um id ou slug solto) e diz o que é, com id, título, espaço e um resumo. Papel mínimo: qualquer.

Entende os endereços do app: espaço (/seção/espaço), post, evento, curso, certificado (de dentro do espaço ou da página pública de verificação), chamada de trabalhos e proposta (?proposal=), plano (/pricing/…) e assinatura (/billing?subscription=…), inclusive os endereços antigos que o app redireciona.

Peça assim: "O que é este link? https://suacomunidade.com.br/aprender/cursos/excel-do-zero"

Notas: só funciona com links da comunidade conectada. Um link de outra comunidade volta "Esse link é de outra comunidade", mesmo que você administre as duas: conecte a outra em separado.

#create_section

Altera

Criar seção. Cria uma seção do menu, como Aprender ou Comunidade. Os espaços moram dentro das seções. Papel mínimo: administrador.

Devolve: a seção criada, com o id que create_space pede.

Peça assim: "Crie uma seção chamada Aprender, visível só para membros."

#create_space

Altera

Criar space. Cria um espaço numa seção, com o módulo que define o que ele é. Papel mínimo: administrador.

Devolve: o espaço criado, com o id e o ícone.

Peça assim: "Crie um espaço de Feed chamado Avisos na seção Comunidade, com o ícone de megafone."

Notas: para um curso ou um evento completo, create_course e create_event criam o espaço junto. Num espaço de Chamada, o próximo passo sugerido é abrir a primeira chamada (create_call_for_papers). Espaços não têm imagem de capa.

#update_space

Altera

Editar space. Muda o nome, a descrição, o ícone ou a visibilidade de um espaço que já existe, ou o move para outra seção. Só o que for enviado muda. Papel mínimo: administrador.

Devolve: o espaço atualizado.

Peça assim: "Troque o ícone do espaço Vagas por uma maleta." · "Dê um ícone diferente a cada espaço da seção Aprender, de acordo com o tema."

#update_section

Altera

Editar seção. Renomeia uma seção do menu, muda a descrição ou o ícone, ou a torna a seção inicial. Só o que for enviado muda. Papel mínimo: administrador.

Peça assim: "Renomeie a seção Aprender para Cursos e faça dela a seção inicial."

Notas: quem vê a seção muda com update_space_access.

#reorder_sections

Altera

Reordenar seções. Põe as seções do menu numa nova ordem, de cima para baixo. As que ficarem de fora mantêm a ordem, depois destas. Papel mínimo: administrador.

Peça assim: "Ponha a seção Eventos logo depois de Comunidade."

#reorder_spaces

Altera

Reordenar spaces. Põe os espaços de uma seção numa nova ordem. Os que ficarem de fora mantêm a ordem, depois destes. Papel mínimo: administrador.

Peça assim: "Na seção Aprender, deixe o espaço Excel do Zero em primeiro."

Notas: para levar um espaço para outra seção, use update_space com section_id.

#update_space_access

Altera

Alterar quem vê o space. Define quem vê um espaço ou uma seção inteira e, num espaço, quem pode postar. Papel mínimo: administrador.

Devolve: o espaço ou a seção atualizados.

Peça assim: "Deixe o espaço Excel do Zero visível só para quem comprou o produto do curso ou assina o plano Aluno."

Notas: os grupos, produtos e planos enviados substituem os que havia; basta um deles para a pessoa entrar. Um espaço nunca fica mais aberto do que a seção dele. Muda quem vê o quê na hora: peça para o assistente mostrar antes o que vai mudar, se quiser conferir. Ver Visibilidade e acesso.

#delete_section

Pede confirmação

Excluir seção. Exclui uma seção do menu e os espaços que estão nela. Papel mínimo: administrador.

Devolve: na primeira chamada, a seção e a lista dos espaços que vão junto, e o código de confirmação.

#delete_space

Pede confirmação

Excluir space. Exclui um espaço e o que ele guarda do menu. Papel mínimo: administrador.

Devolve: na primeira chamada, o espaço, o módulo e a seção, e o código de confirmação.

#get_community_settings

Só consulta

Ver configurações da comunidade. As configurações da comunidade como estão. Papel mínimo: administrador.

Parâmetros: nenhum.

Devolve: o nome, a descrição, as cores (primária e secundária em hex, e a escala completa), o logo, o favicon, a imagem de compartilhamento, o SEO, as regras de entrada (cadastro aberto, modelo de cadastro, visitantes), a moderação e o ranking. Nada de segredo, como integrações ou DNS.

Peça assim: "Quais são as cores e o SEO da comunidade hoje?"

#update_community_settings

Altera

Alterar configurações da comunidade. Muda as configurações; só o que for enviado muda. Papel mínimo: administrador.

Devolve: as configurações aplicadas, com o antes → depois de cada campo.

Peça assim: "Troque a cor primária para #4F46E5 e use este logo: https://…"

Notas: tudo isso aparece para a comunidade inteira assim que a chamada roda; para desfazer, peça de novo com o valor antigo, que está no antes → depois. Domínio e integrações não se mudam por aqui. Ver Configurações gerais.

#get_notification_settings

Só consulta

Ver avisos de venda. Para onde vão os avisos da comunidade: o e-mail que recebe um aviso a cada venda. Papel mínimo: administrador.

Parâmetros: nenhum.

Peça assim: "Quem recebe o aviso quando sai uma venda?"

#update_notification_settings

Altera

Alterar e-mail dos avisos de venda. Define o e-mail que recebe um aviso a cada venda. Papel mínimo: administrador.

Peça assim: "Mande os avisos de venda para [email protected]."

Ver Avisos de venda.

#Ícones

Os espaços usam os mesmos ícones do seletor do painel. O assistente recebe a lista com o uso de cada um (em get_community_context, campo available_icons, e na descrição das ferramentas) e é instruído a escolher pelo tema, sem repetir sempre o mesmo. Se não escolher, a Memberfy escolhe pelo título (Agenda de lives ganha calendar, Vagas ganha briefcase) ou, sem pista no título, pelo módulo (Cursos ganha book-open, Galeria ganha image).

Alguns exemplos: calendar (eventos, agenda), book-open (cursos, aulas), graduation-cap (formação, mentoria), megaphone (avisos, anúncios), message-square (fórum, dúvidas), briefcase (carreira, vagas), image (galeria, fotos), trophy (ranking, desafios), shopping-bag (loja), crown (premium, VIP), lock (privado).

#get_connection_diagnostics

Só consulta

Diagnóstico da conexão. Diz se a lista de ferramentas que o assistente está usando está em dia. Papel mínimo: administrador (proprietário ou administrador).

Devolve: o assistente, quem autorizou e quando, a versão do servidor e a lista que a conexão receberia agora (o código da lista e quantas ferramentas), o que ela recebeu da última vez, a última chamada e a última tentativa de usar uma ferramenta que ela não tem, e listUpToDate. Com listUpToDate falso, o assistente está com a lista antiga: abra uma conversa nova ou reconecte o conector.

Peça assim: "Uma chamada sua falhou. Sua lista de ferramentas da Memberfy está em dia?"

#Relacionados

• Ferramentas
• Receitas
• Dinheiro e confirmação