Convites Ótimos

Nota: Para informação sobre como configurar o seu sistema de servidor para suportar a criação de convites desse tipo, por gentileza consulte a nossa seção de auto-hospedagem.

O propósito deste tutorial é delinear como criar convites para os clientes mais populares de acordo com XEP-0401: Geração de Convites de Contas Ad-hoc. Para um entendimento básico é crucial saber que há dois tipos de convites:

  • Convite de Usuário

    Uma maneira fácil e rápida de adicionar alguém aos seus contatos, sem interação adicional.

  • Criação de Conta

    Permite registrar uma conta nova no seu servidor.

Nota: Dependendo da configuração do servidor, pode ainda ser possível criar uma nova conta usando um Convite de Usuário. Da mesma forma, um convite de Criação de Conta pode ser configurado para que ele também crie uma inscrição mutual. Ainda mais, o último permite que você pré-configure um nome de conta. Algo que não pode ser feito utilizando um Convite de Usuário.

Após criar um convite, você deve receber um URL da landing page, que você deve encaminhar para uma outra pessoa usando algo como email, SMS ou qualquer outra maneira de comunicação digital. Alguns apps podem até exibir um QR code, que você pode mostrar à pessoa diretamente, se ela estiver perto. Tipicamente tal URL é semelhante a este:

1https://example.com/invites/0camZqFi19rfSlVD8C4IaUFo

Quando abri-lo em um navegador você deve ver alguma coisa assim (o design vai variar de servidor a servidor):

Uma página web, vista em um smartphone, mostrando que você foi convidado para se conectar, e um grande botão para adicionar alguém à sua lista de contatos. Além disso, ela mostra uma seleção de clientes para instalação.
Landing page para Convite de Usuário
Uma página web, vista em um smartphone, mostrando que você foi convidado a criar uma conta, seguido de instruções de como começar.
Landing page para Criação de Conta

Dependendo da configuração do seu servidor e das capacidades do cliente, algumas vezes você pode acabar com apenas um URI XMPP para compartilhar. Eles se parecem com isso:

1xmpp:inviter@example.com?roster;preauth=0camZqFi19rfSlVD8C4IaUFo;ibr=y

Esses URIs apenas funcionam se o destinatário já tiver um app XMPP compatível instalado e o app de terceiros recebendo esses URIs os suporta.

Dica: Nós oferecemos um serviço aqui na joinjabber.org, que permite você transformar tal URI em uma landing page. Essa maneira de compartilhar convites é muito mais fácil de usar. Além disso, ela dá sugestões de clientes compatíveis para a instalação, caso seja necessário.
Nota: Seria melhor perguntar ao seu administrador de servidor a configurar uma landing page adequada. Oferecemos orientações sobre como fazer isso na nossa seção de auto-hospedagem.
Acesse a conta do Gajim através do botão no canto inferior esquerdo, daí navegue para as opções expandidas no canto superior direito e selecione 'Executar Comando' do menu drop-down.
Selecione "Executar Comando" da aba de contas.
Diálogo de comandos disponíveis onde você escolhe entre 'Convidar Usuário' (Convite de Usuário) ou 'Criar Conta' (Criação de Conta)
Lista de comandos disponíveis, mostrando ambos os tipos de convites (dependendo da configuração do servidor)
Um formulário mostrando campos para 'Nome de Usuário' e uma caixa de seleção para 'Inscrição de Escala'
Preencha o formulário para Criação de Conta, parâmetros são opcionais.
Um diálogo mostrando os valores 'URL da Landing Page do Convite', 'URI do Convite' e 'Token de convite válida até' como resultado de submeter o formulário. Esses valores podem ser selecionados para serem enviados ao seu convidado.
Resultado de Criação de Conta mostrando uma landing page e um URI XMPP.
Da janela principal do Monal clique no ícone de amigos no canto superior direito.
Aperte no ícone de amigos.
Na lista de contato do Monal clique no ícone 'adicionar contato' no canto superior direito.
Clique no ícone 'adicionar contato'.
Clique no botão de compartilhar no canto superior direito, à esquerda do ícone da camera. Vai aparecer uma tela com um QR code e um botão 'compartilhar link de convite'.
Clique no botão de compartilhar.
Na tela principal clique no ícone de QR code no canto superior direito.
Selecione o símbolo de QR code da tela principal.
Do menu dropdown selecione o último, terceiro do topo, rotulado 'Convide ao servidor'.
Selecione 'Convide ao servidor' do dropdown.
Você é apresentado com um QR code e um botão de compartilhar no final da tela.
Compartilhar resultado ou mostrar QR code.
Clique no ícone de conta no canto superior esquerdo, clique no ícone de configuração embaixo do ícone de conta, clique em 'Ações' na tela de configuração, selecione 'Convidar Usuário' ou 'Criar Conta'.
Selecione o tipo de convite da tela de configuração do Movim.
Formulário mostra um campo 'Nome de Usuário' e um toggle 'Inscrição Roster'. Botão para submeter formulário no canto inferior direito.
Preencha o formulário Criar Conta.
A janela de resultado mostra 'URL da Landing Page do Convite', 'URI do Convite' e 'Token de convite válida até'.
Janela de resultado com o URL da landing page e um URI XMPP.
Envie '/cmd list' da janela principal do profanity.
Envie /cmd list para obter uma lista de comandos disponíveis.
Envie '/cmd exec urn:xmpp:invite#create-account' para receber um formulário ad-hoc com field1 'Username' e field2 'Roster Subscription'. Instruções dizem envie '/form submit', '/form cancel' ou '/form help'.
Envie /cmd exec urn:xmpp:invite#create-account para obter um formulário ad-hoc.
Envie '/form submit' para criar um convite. O resultado mostra 'Invite Landing Page URL' (field1), 'Invite URI' (field2) e 'Invite token valid until' (field3).
Envie /form submit para obter a tela de resultados com o URL da landing page e um URI XMPP.

Clientes populares que não suportam essa função, desde Fevereiro 2026. Note, pode ser que ainda consigam receber tais convites.

  • Dino
  • Kaidan
  • Beagle
  • Siskin
  • Snikket (iOS)