X
X, anteriormente conhecido como Twitter, é um serviço de rede social on-line que permite aos usuários enviar e receber mensagens curtas. Conecte-se ao X para gerenciar suas postagens. Você pode realizar várias ações, como enviar posts, pesquisar, ver seguidores, etc.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Standard | Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Automatize o poder | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Microsoft Power Automate Suporte Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://x.com/ |
| Política de privacidade | https://x.com/privacy |
Autenticação e traga seu próprio aplicativo
Importante
O aplicativo compartilhado padrão (aplicativo cliente do Twitter mantido pela Microsoft) não está mais disponível. O conector agora suporta apenas um tipo de autenticação - Traga seu próprio aplicativo. A partir de junho de 2023, ele exigirá um aplicativo de camada Enterprise pago. No entanto, a política de preços do Twitter pode continuar a mudar.
Com a opção "Traga seu próprio aplicativo", você pode usar seu próprio aplicativo Twitter OAuth Client. Isso permite que você controle permissões e habilite certas limitações no uso do conector.
Para usar seu próprio aplicativo Twitter OAuth Client com o conector do Twitter, você precisará executar as seguintes etapas:
- Criar um aplicativo cliente OAuth usando a página do desenvolvedor do Twitter (https://developer.twitter.com)
- Use o aplicativo no conector do Twitter
Criando um aplicativo cliente OAuth no Twitter
Para criar seu próprio aplicativo cliente OAuth do Twitter, você precisará primeiro entrar no https://developer.twitter.com. Navegue até a seção "Projetos & Apps", que é onde você pode gerenciar e criar aplicativos twitter. Esse processo é explicado no Guia do desenvolvedor do Twitter do Twitter. Depois de criar o aplicativo twitter na página do desenvolvedor, as seguintes etapas são necessárias para a configuração adequada:
- Selecione seu aplicativo do twitter
- Edite as permissões do aplicativo para habilitar a leitura e a gravação.
- Editar configurações de autenticação
- Ativar autenticação de terceiros 3rd
- Adicionar
https://global.consent.azure-apim.net/redirectpara as URLs de retorno de chamada (NOTA: Se você estiver usando a assinatura do Fairfax ou o ambiente do GCC, consulte a seção "Retornos de chamada Fairfax e GCC") - Definir "URL do site" (campo obrigatório, mas seu valor não afeta o fluxo)
Retornos de chamada Fairfax e GCC
Se você estiver usando a assinatura Fairfax ou o ambiente GCC, adicione as seguintes URLs para as URLs de retorno de chamada do seu aplicativo do Twitter:
- Para Fairfax:
https://logic-apis-usgovvirginia.consent.azure-apihub.us/redirecthttps://logic-apis-usgovtexas.consent.azure-apihub.us/redirecthttps://logic-apis-usgovarizona.consent.azure-apihub.us/redirect
- Para o GCC:
https://power-apis-usgov001-public.consent.azure-apihub.us/redirect
Quando terminar, selecione seu aplicativo do Twitter e navegue até a página "Chaves e tokens". Na seção "Chaves do consumidor", clique no botão "Exibir chaves" para obter a chave da API e o segredo da chave da API do seu aplicativo. Agora você pode usar esses valores em sua conexão com o Twitter.
Usando seu próprio aplicativo no conector do Twitter
Depois de criar o aplicativo cliente Twitter OAuth, você pode usá-lo ao criar uma conexão com o Twitter.
- Selecione Traga seu próprio aplicativo.
- Especifique os valores de ID do Cliente e Segredo do Cliente do seu aplicativo. (Use a chave da API e o segredo da chave da API do seu aplicativo do Twitter)
Clique em Entrar para entrar na sua conta do Twitter. Isso solicitará que você faça login na sua conta do Twitter e, em seguida, autorize o acesso ao aplicativo do Twitter que você criou acima.
LIMITES
Eis alguns dos limites e restrições:
- Número máximo de conexões por usuário: 2
- Limite de taxa de chamada API para operação POST: 12 por hora
- Limite de taxa de chamada da API para outras operações: 600 por hora
- Frequência das sondagens de gatilho: 1 hora
- Tamanho máximo do upload da imagem: 5 MB
- Tamanho máximo do upload de vídeo: 15 MB
- Número máximo de resultados da pesquisa: 100
- Número máximo de novos tweets rastreados dentro de um intervalo de votação: 5
- O comprimento máximo permitido do valor do parâmetro 'Pesquisar texto' é 470
Restrições da API do Twitter
- Pesquisas da API de pesquisa em relação a uma amostra de Tweets recentes publicados nos últimos 7 dias
- A API de pesquisa padrão é focada na relevância e não na completude. Isso significa que alguns Tweets e usuários podem estar faltando nos resultados da pesquisa
Restrições adicionais para a operação POST
Não há suporte para mencionar um @user tweet ao postar um tweet. Especificamente, os caracteres "@" serão removidos ao postar um tweet.
Limites Gerais
| Nome | Valor |
|---|---|
| Ligações por conta | 2 |
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Traga a sua própria candidatura | Faça login usando seu próprio aplicativo do Twitter. Para obter mais detalhes, consulte a seção 'Autenticação e traga seu próprio aplicativo' nesta página. | Todas as regiões | Não compartilhável |
| Padrão [DEPRECATED] | Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. | Todas as regiões | Não compartilhável |
Traga a sua própria candidatura
ID da autenticação: byoa
Aplicável: Todas as regiões
Faça login usando seu próprio aplicativo do Twitter. Para obter mais detalhes, consulte a seção 'Autenticação e traga seu próprio aplicativo' nesta página.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave do consumidor | cadeia (de caracteres) | Chave de consumidor do seu aplicativo do Twitter | Verdade |
| Segredo do Consumidor | securestring | Segredo do cliente do seu aplicativo do Twitter | Verdade |
Padrão [DEPRECATED]
Aplicável: Todas as regiões
Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Ações
| Cronologia Chegar a casa |
Esta operação recebe os tweets e retweets mais recentes postados por mim e meus seguidores. |
| Obter linha do tempo do usuário |
Esta operação obtém uma lista dos tweets mais recentes postados por um determinado usuário. |
| Obter os meus seguidores |
Esta operação obtém a lista de usuários que estão me seguindo. |
| Obter os meus seguidores |
Esta operação obtém a lista de usuários que estou seguindo. |
| Obter seguidores |
Esta operação obtém a lista de usuários que seguem um determinado usuário. |
| Obter utilizador |
Esta operação obtém os detalhes do perfil de um determinado usuário, como nome de usuário, descrição, contagem de seguidores e muito mais. |
| Pesquisar tweets |
Esta operação obtém uma lista de tweets relevantes correspondentes à consulta de pesquisa. |
| Publicar um tweet |
Esta operação publica um novo tweet. |
| Retweetar |
Esta operação retweeta um tweet. |
| Siga |
A operação obtém a lista de pessoas que o usuário determinado segue. |
Cronologia Chegar a casa
Esta operação recebe os tweets e retweets mais recentes postados por mim e meus seguidores.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Resultados máximos
|
maxResults | integer |
Número máximo de tweets a serem retornados. |
Devoluções
- response
- array of TweetModel
Obter linha do tempo do usuário
Esta operação obtém uma lista dos tweets mais recentes postados por um determinado usuário.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome de utilizador
|
userName | True | string |
Identificador X para o utilizador. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de tweets a serem retornados. |
Devoluções
- response
- array of TweetModel
Obter os meus seguidores
Esta operação obtém a lista de usuários que estão me seguindo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuários a obter. |
Devoluções
- response
- array of UserDetailsModel
Obter os meus seguidores
Esta operação obtém a lista de usuários que estou seguindo.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuários a retornar. |
Devoluções
- response
- array of UserDetailsModel
Obter seguidores
Esta operação obtém a lista de usuários que seguem um determinado usuário.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome de utilizador
|
userName | True | string |
Identificador X para o utilizador. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuários a retornar. |
Devoluções
- response
- array of UserDetailsModel
Obter utilizador
Esta operação obtém os detalhes do perfil de um determinado usuário, como nome de usuário, descrição, contagem de seguidores e muito mais.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome de utilizador
|
userName | True | string |
Identificador X para o utilizador. |
Devoluções
Representa um usuário.
- Body
- UserDetailsModel
Pesquisar tweets
Esta operação obtém uma lista de tweets relevantes correspondentes à consulta de pesquisa.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Pesquisar texto
|
searchQuery | True | string |
Pesquise termos como "happy hour", #haiku, de:@username, amor OU ódio. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de tweets a serem retornados. |
|
|
desdeId
|
sinceId | string |
Retorne tweets após o ID de tweet especificado. |
Devoluções
- response
- array of TweetModel
Publicar um tweet
Esta operação publica um novo tweet.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Tweetar texto
|
tweetText | string |
Texto a ser postado. |
|
|
MÍDIA
|
body | binary |
Mídia a ser postada. |
Devoluções
Representa a resposta de uma publicação de tweet.
- Body
- TweetResponseModel
Retweetar
Esta operação retweeta um tweet.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do tweet
|
tweetId | True | string |
Tweet para ser retweetado. |
|
Cortar usuário
|
trimUser | boolean |
Boolean para indicar se as informações do usuário devem ser cortadas. |
Devoluções
Representa a resposta de uma publicação de tweet.
- Body
- TweetResponseModel
Siga
A operação obtém a lista de pessoas que o usuário determinado segue.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome de utilizador
|
userName | True | string |
Identificador X para o utilizador. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuários a retornar. |
Devoluções
- response
- array of UserDetailsModel
Acionadores
| Quando um novo tweet é publicado |
Essa operação dispara um fluxo quando um novo tweet que corresponde a uma determinada consulta de pesquisa é publicado. |
Quando um novo tweet é publicado
Essa operação dispara um fluxo quando um novo tweet que corresponde a uma determinada consulta de pesquisa é publicado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Pesquisar texto
|
searchQuery | True | string |
Pesquise termos como "happy hour", #haiku, de:@username, amor OU ódio. |
Devoluções
Representa um objeto wrapper para resposta de gatilho em lote
Definições
TweetModel
Representa uma publicação de tweet.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Tweetar texto
|
TweetText | string |
Conteúdo de texto do tweet |
|
ID do tweet
|
TweetId | string |
Id do tweet |
|
Criado(a) a
|
CreatedAtIso | string |
Hora em que o tweet foi publicado |
|
Contagem de retweets
|
RetweetCount | integer |
Número total de retuítes para o tweet |
|
Tweeted por
|
TweetedBy | string |
Nome do usuário que publicou o tweet |
|
urls de mídia
|
MediaUrls | array of string |
URL da mídia postada junto com o tweet |
|
Idioma do tweet
|
TweetLanguageCode | string |
Código do idioma do tweet |
|
in_reply_to_user_id
|
TweetInReplyToUserId | string |
ID de usuário do autor do tweet ao qual o tweet atual é uma resposta |
|
Favorito
|
Favorited | boolean |
Indica se o tweet está marcado como favorito ou não |
|
Menções do utilizador
|
UserMentions | array of UserMentionsModel |
Lista de usuários mencionados no tweet |
|
OriginalTweet
|
OriginalTweet | OriginalTweetModel |
Representa uma publicação de tweet original. |
|
Detalhes do usuário
|
UserDetails | UserDetailsModel |
Representa um usuário. |
UserMentionsModel
Representa um usuário mencionado em um tweet.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de utilizador mencionado
|
Id | integer |
X id (handle) do utilizador |
|
Nome completo do usuário mencionado
|
FullName | string |
Nome completo do utilizador |
|
Nome de utilizador mencionado
|
UserName | string |
Nome de utilizador |
OriginalTweetModel
Representa uma publicação de tweet original.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto original do tweet
|
TweetText | string |
Conteúdo de texto do tweet original recuperado |
|
ID do tweet original
|
TweetId | string |
Id do tweet original |
|
Tweet original criado em
|
CreatedAtIso | string |
Hora em que o tweet original foi publicado |
|
Contagem de retweets originais
|
RetweetCount | integer |
Número total de retweets para este tweet original |
|
Tweet original tweetado por
|
TweetedBy | string |
Nome de usuário da pessoa que publicou o tweet original |
|
urls de mídia de tweet originais
|
MediaUrls | array of string |
URL da mídia postada junto com o tweet original |
|
Idioma original do tweet
|
TweetLanguageCode | string |
Código de idioma para o tweet original |
|
Tweet original in_reply_to_user_id
|
TweetInReplyToUserId | string |
ID de usuário do autor do tweet ao qual o tweet original atual é uma resposta |
|
Tweet original favorito
|
Favorited | boolean |
Indica se o tweet original está marcado como favorito |
|
Menções originais do usuário do tweet
|
UserMentions | array of OriginalTweetUserMentionsModel |
A lista de usuários mencionados no tweet |
|
Detalhes do usuário
|
UserDetails | OriginalTweetUserDetailsModel |
Representa um usuário que publicou um tweet original |
UserDetailsModel
Representa um usuário.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
FullName | string |
Nome do utilizador |
|
Localização
|
Location | string |
Localização do utilizador |
|
ID do utilizador
|
Id | integer |
X id (handle) do utilizador |
|
Nome de utilizador
|
UserName | string |
Nome de utilizador |
|
Contagem de seguidores
|
FollowersCount | integer |
Número de seguidores |
|
Description
|
Description | string |
Descrição do utilizador |
|
Contagem de status
|
StatusesCount | integer |
Contagem de status do usuário |
|
Amigos contam
|
FriendsCount | integer |
Número de amigos |
|
Favoritos contam
|
FavouritesCount | integer |
Número de tweets que o usuário favoreceu |
|
URL da imagem de perfil
|
ProfileImageUrl | string |
URL da imagem de perfil |
OriginalTweetUserMentionsModel
Representa um usuário mencionado em um tweet original.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Tweet original mencionou ID de usuário
|
Id | integer |
X id (handle) do utilizador |
|
Tweet original mencionou o nome completo do usuário
|
FullName | string |
Nome completo do utilizador |
|
Tweet original mencionou nome de usuário
|
UserName | string |
Nome de utilizador |
OriginalTweetUserDetailsModel
Representa um usuário que publicou um tweet original
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome completo original do usuário do tweet
|
FullName | string |
Nome do utilizador |
|
Localização original do usuário do tweet
|
Location | string |
Localização do utilizador |
|
ID de usuário original do tweet
|
Id | integer |
X id (handle) do utilizador |
|
Nome de usuário original do tweet
|
UserName | string |
Nome de utilizador |
|
Contagem de seguidores de usuários do tweet original
|
FollowersCount | integer |
Número de seguidores |
|
Descrição original do usuário tweet
|
Description | string |
Descrição do utilizador |
|
Contagem de status do usuário do tweet original
|
StatusesCount | integer |
Contagem de status do usuário |
|
Contagem de amigos do usuário do tweet original
|
FriendsCount | integer |
Número de amigos |
|
Contagem de favoritos dos usuários do tweet original
|
FavouritesCount | integer |
Número de tweets que o usuário favoreceu |
|
URL original da imagem do perfil do usuário do tweet
|
ProfileImageUrl | string |
URL da imagem de perfil |
TweetResponseModel
Representa a resposta de uma publicação de tweet.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do tweet
|
TweetId | string |
ID do tweet publicado |
TriggerBatchResponse[TweetModel]
Representa um objeto wrapper para resposta de gatilho em lote
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of TweetModel |
Uma lista dos objetos de resposta |