Skip to main content
Web Intents fornecem fluxos para trabalhar com Tweets e usuários do X: Tweet, Reply, Retweet, Like e Follow. Eles possibilitam que os usuários interajam com o conteúdo do X no contexto do seu site, sem sair da página ou ter que autorizar um novo app apenas para a interação. Web intents são compatíveis com a web mobile, incluem handlers de app nativo no iOS e Android quando o app do X está instalado, e são super fáceis de implementar.

Trabalhando com Web Intents

Web Intents são a forma mais simples de permitir que as pessoas façam Tweet ou sigam contas do X diretamente do seu site. Web Intents automaticamente trazem um visualizador para a melhor experiência logada para concluir sua ação especificada, incluindo compositores de Tweet ou visualizações de perfil do X dentro dos apps X for iOS e X for Android. Se um visualizador não tiver uma conta do X, ele terá a oportunidade de fazer login no X ou criar uma conta antes de concluir a ação originalmente especificada. Web Intents não exigem configurar uma aplicação do X, armazenar credenciais de app ou solicitar permissões de app a um visualizador antes de publicar. O JavaScript do X for Websites disparará automaticamente eventos JavaScript apropriados quando incluído em uma página web. Web Intents não podem ser carregados dentro de um iframe. Um autor do X deve visualizar a página web completa antes de decidir criar um novo Tweet ou uma Tweet action pré-preenchida pelo seu Web Intent especificado ou seguir uma conta do X especificada. Imagens para ícones de likes, replies e reposts estão todas disponíveis em nossa página de Recursos de imagem. Consulte nossos Display Requirements para dicas sobre como renderizar Tweets e outros recursos do X. Se sua audiência falar um idioma diferente do inglês, recomendamos que você use intents localizados.

Começar

Web Intents podem ser invocados de forma flexível por meio de uma combinação leve de JavaScript e HTML e destinam-se a ser abertos em uma nova janela. A forma mais fácil de usar intents é incluir o JavaScript do X for Websites em qualquer página web onde você queira invocar um intent. Se você já configurou o Tweet button, já está preparado para Web Intents. Quando combinado com tags âncora padrão e iconografia familiar como os exemplos abaixo, este JavaScript abrirá automaticamente uma janela do tamanho apropriado quando clicado. Você só precisa carregar platform.x.com/widgets.js uma vez.

Lista de Web Intents

Tweet ou Reply a um Tweet

Consulte a documentação do Tweet Web Intent para mais informações sobre o Tweet intent.

Retweet a um Tweet

Retweets são uma forma poderosa de permitir que seus usuários compartilhem seu conteúdo com seus seguidores.

Parâmetros suportados

  • tweet_id
Todo Tweet é identificado por um ID. Você pode encontrar esse valor na API ou visualizando a página de permalink de qualquer Tweet, geralmente acessível ao clicar na data de “publicação” de um tweet.

Like a um Tweet

Os usuários curtem por várias razões: quando amam um Tweet, quando querem salvá-lo para depois ou para oferecer um sinal de agradecimento. O like intent permite fornecer essa Tweet action e fazer follow-up com contas relevantes sugeridas para o usuário seguir.

Parâmetros suportados

  • tweet_id
Todo Tweet é identificado por um ID. Você pode encontrar esse valor na API ou visualizando a página de permalink de qualquer Tweet, geralmente acessível ao clicar no timestamp exibido ao lado de um Tweet.

Mini-Perfil

Este Intent oferece uma maneira discreta de vincular nomes de pessoas, empresas e serviços às suas contas do X. A nova aba apresenta em destaque a foto de perfil da conta, bio, tweets recentes e um botão Follow fácil de usar. Mais recursos de imagem.

Parâmetros suportados

  • screen_name
Todo usuário do X tem um screen name, mas eles estão sujeitos a mudanças. Recomendamos usar user_id sempre que possível.
  • user_id
Os X User IDs estão disponíveis na API e identificam um usuário de forma única.

Follow

Um follow Web Intent exibe um formulário inline de sign in para usuários deslogados e segue a conta X alvo em caso de login bem-sucedido.

Localização

Você pode passar um parâmetro de query lang como parte de qualquer web intent para sobrescrever a exibição de idioma de um usuário logado ou os idiomas aceitos por um navegador. Consulte idiomas do X for Websites para uma lista de valores lang suportados.

Otimização

Dependências limitadas

Alguns sites podem preferir incorporar o JavaScript de web intents discretos inline ou sem uma dependência do platform.twitter.com. O snippet abaixo oferecerá a funcionalidade equivalente sem a dependência externa.
Exemplo