X
X, anteriormente conhecido como Twitter, é um serviço de rede social online que permite que os usuários enviem e recebam postagens curtas. Conecte-se ao X para gerenciar suas postagens. Você pode executar várias ações, como enviar postagens, pesquisar, exibir seguidores etc.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Power Automate | Standard | Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | 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 dá suporte a apenas um tipo de autenticação : traga seu próprio aplicativo. A partir de junho de 2023, ele requer 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 Cliente OAuth do Twitter. Isso permite controlar as permissões e habilitar determinadas limitações no uso do conector.
Para usar seu próprio aplicativo Cliente OAuth do Twitter com o conector do Twitter, você precisará executar as seguintes etapas:
- Criar um aplicativo cliente OAuth usando a página de desenvolvedor do Twitter (https://developer.twitter.com)
- Usar o aplicativo no conector do Twitter
Criando um aplicativo cliente OAuth no Twitter
Para criar seu próprio aplicativo cliente OAuth no Twitter, você precisará primeiro entrar.https://developer.twitter.com Navegue até a seção "Projetos & Aplicativos", que é onde você pode gerenciar e criar aplicativos do 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 twitter
- Edite permissões de aplicativo para habilitar leitura e gravação.
- Editar configurações de autenticação
- Habilitar autenticação de terceiros
- Adicione
https://global.consent.azure-apim.net/redirectas URLs de retorno de chamada (OBSERVAÇÃO: se você estiver usando a assinatura fairfax ou o ambiente GCC, examine a seção "Retornos de chamada fairfax e GCC") - Defina "URL do Site" (campo necessário, mas seu valor não afeta o fluxo)
Retornos de chamada de 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 GCC:
https://power-apis-usgov001-public.consent.azure-apihub.us/redirect
Depois de terminar, selecione seu aplicativo 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 de API e o segredo da chave de 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 OAuth do Twitter, você poderá usá-lo durante a criação de uma conexão do Twitter.
- Selecione Traga seu próprio aplicativo.
- Especifique os valores de ID do cliente e segredo do cliente do aplicativo. (Use a chave de API e o segredo da chave de API do seu aplicativo twitter)
Clique em Entrar para entrar em sua conta do Twitter. Isso solicitará que você entre em sua conta do Twitter e, em seguida, autorize o acesso ao aplicativo twitter que você criou acima.
LIMITES
Veja a seguir alguns dos limites e restrições:
- Número máximo de conexões por usuário: 2
- Limite de taxa de chamada de API para a operação POST: 12 por hora
- Limite de taxa de chamada de API para outras operações: 600 por hora
- Frequência das pesquisas de gatilho: 1 hora
- Tamanho máximo do upload de 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 em um intervalo de sondagem: 5
- O tamanho máximo do valor do parâmetro 'Texto de pesquisa' permitido é 470
Restrições da API do Twitter
- Pesquisar pesquisas de API em uma amostragem de Tweets recentes publicados nos últimos 7 dias
- A API de pesquisa padrão se concentra na relevância e não na integridade. Isso significa que alguns tweets e usuários podem estar ausentes dos resultados da pesquisa
Restrições adicionais para a operação POST
Não há suporte para a menção de um @user tweet ao postar um tweet. Especificamente, os caracteres "@" serão despojados ao postar um tweet.
Limites Gerais
| Nome | Value |
|---|---|
| Conexões por conta | 2 |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Traga seu próprio aplicativo | Entre 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 [PRETERIDO] | Essa 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 seu próprio aplicativo
ID de autenticação: byoa
Aplicável: todas as regiões
Entre 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia 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 | Chave do consumidor do seu aplicativo do Twitter | Verdade |
| Segredo do consumidor | secureString | Segredo do cliente do seu aplicativo do Twitter | Verdade |
Padrão [PRETERIDO]
Aplicável: todas as regiões
Essa 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Ações
| Obter a linha do tempo do usuário |
Esta operação obtém uma lista dos tweets mais recentes postados por um determinado usuário. |
| Obter as seguintes opções |
A operação obtém a lista de pessoas que o usuário determinado segue. |
| Obter linha do tempo de casa |
Esta operação obtém os tweets e tweets mais recentes postados por mim e meus seguidores. |
| Obter meus seguidores |
Esta operação obtém a lista de usuários que estão me seguindo. |
| Obter o meu seguinte |
Esta operação obtém a lista de usuários que estou seguindo. |
| Obter seguidores |
Essa operação obtém a lista de usuários que seguem um determinado usuário. |
| Obter usuário |
Essa 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 que correspondem à consulta de pesquisa. |
| Postar um tweet |
Esta operação publica um novo tweet. |
| Retweet |
Esta operação retuita um tweet. |
Obter a 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
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome de usuário
|
userName | True | string |
Identificador X para o usuário. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de tweets a serem retornados. |
Retornos
- response
- array of TweetModel
Obter as seguintes opções
A operação obtém a lista de pessoas que o usuário determinado segue.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome de usuário
|
userName | True | string |
Identificador X para o usuário. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuários a serem retornados. |
Retornos
- response
- array of UserDetailsModel
Obter linha do tempo de casa
Esta operação obtém os tweets e tweets mais recentes postados por mim e meus seguidores.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Resultados máximos
|
maxResults | integer |
Número máximo de tweets a serem retornados. |
Retornos
- response
- array of TweetModel
Obter meus seguidores
Esta operação obtém a lista de usuários que estão me seguindo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuários a serem obtidos. |
Retornos
- response
- array of UserDetailsModel
Obter o meu seguinte
Esta operação obtém a lista de usuários que estou seguindo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuários a serem retornados. |
Retornos
- response
- array of UserDetailsModel
Obter seguidores
Essa operação obtém a lista de usuários que seguem um determinado usuário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome de usuário
|
userName | True | string |
Identificador X para o usuário. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuários a serem retornados. |
Retornos
- response
- array of UserDetailsModel
Obter usuário
Essa 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
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome de usuário
|
userName | True | string |
Identificador X para o usuário. |
Retornos
Representa um usuário.
- Corpo
- UserDetailsModel
Pesquisar tweets
Esta operação obtém uma lista de tweets relevantes que correspondem à consulta de pesquisa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pesquisar texto
|
searchQuery | True | string |
Termo de pesquisa como "happy hour", #haiku, de:@username, amor ou ódio. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de tweets a serem retornados. |
|
|
sinceId
|
sinceId | string |
Retorne tweets após a ID do tweet especificada. |
Retornos
- response
- array of TweetModel
Postar um tweet
Esta operação publica um novo tweet.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Texto do tweet
|
tweetText | string |
Texto a ser postado. |
|
|
Mídia
|
body | binary |
Mídia a ser postada. |
Retornos
Representa a resposta de uma postagem de tweet.
- Corpo
- TweetResponseModel
Retweet
Esta operação retuita um tweet.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tweet
|
tweetId | True | string |
Tweet a ser retuitado. |
|
Cortar usuário
|
trimUser | boolean |
Booliano para indicar se as informações do usuário devem ser aparadas. |
Retornos
Representa a resposta de uma postagem de tweet.
- Corpo
- TweetResponseModel
Gatilhos
| Quando um novo tweet é postado |
Essa operação dispara um fluxo quando um novo tweet que corresponde a uma determinada consulta de pesquisa é postado. |
Quando um novo tweet é postado
Essa operação dispara um fluxo quando um novo tweet que corresponde a uma determinada consulta de pesquisa é postado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pesquisar texto
|
searchQuery | True | string |
Termo de pesquisa como "happy hour", #haiku, de:@username, amor ou ódio. |
Retornos
Representa um objeto wrapper para a resposta do gatilho em lotes
Definições
TweetModel
Representa uma postagem de tweet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto do tweet
|
TweetText | string |
Conteúdo de texto do tweet |
|
ID do tweet
|
TweetId | string |
ID do tweet |
|
Criado em
|
CreatedAtIso | string |
Hora em que o tweet foi postado |
|
Contagem de retweets
|
RetweetCount | integer |
Número total de tweets para o tweet |
|
Tuitado por
|
TweetedBy | string |
Nome do usuário que postou 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 de idioma do tweet |
|
in_reply_to_user_id
|
TweetInReplyToUserId | string |
ID do usuário do autor do tweet ao qual o tweet atual é uma resposta |
|
Favoritos
|
Favorited | boolean |
Indica se o tweet está marcado como favorito ou não |
|
Menções do usuário
|
UserMentions | array of UserMentionsModel |
Lista de usuários mencionados no tweet |
|
OriginalTweet
|
OriginalTweet | OriginalTweetModel |
Representa uma postagem de tweet original. |
|
Detalhes do usuário
|
UserDetails | UserDetailsModel |
Representa um usuário. |
UserMentionsModel
Representa um usuário mencionado em um tweet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de usuário mencionada
|
Id | integer |
ID X (identificador) do usuário |
|
Nome completo do usuário mencionado
|
FullName | string |
Nome completo do usuário |
|
Nome de usuário mencionado
|
UserName | string |
Nome de tela do usuário |
OriginalTweetModel
Representa uma postagem de tweet original.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto do tweet original
|
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 postado |
|
Contagem original de retweets de tweet
|
RetweetCount | integer |
Número total de tweets para este tweet original |
|
Tweet original tuitado por
|
TweetedBy | string |
Nome de usuário da pessoa que postou 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 que o tweet original atual é uma resposta a |
|
Tweet original favorito
|
Favorited | boolean |
Indica se o tweet original está marcado como favorito |
|
Menções de usuário de tweet original
|
UserMentions | array of OriginalTweetUserMentionsModel |
A lista de usuários mencionados no tweet |
|
Detalhes do usuário
|
UserDetails | OriginalTweetUserDetailsModel |
Representa um usuário que postou um tweet original |
UserDetailsModel
Representa um usuário.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
FullName | string |
Nome do utilizador |
|
Localização
|
Location | string |
Localização do usuário |
|
ID do usuário
|
Id | integer |
ID X (identificador) do usuário |
|
Nome de usuário
|
UserName | string |
Nome de tela do usuário |
|
Contagem de seguidores
|
FollowersCount | integer |
Número de seguidores |
|
Description
|
Description | string |
Descrição do usuário |
|
Contagem de status
|
StatusesCount | integer |
Contagem de status do usuário |
|
Contagem de amigos
|
FriendsCount | integer |
Número de amigos |
|
Contagem de favoritos
|
FavouritesCount | integer |
Número de tweets que o usuário tem favoritos |
|
URL da imagem de perfil
|
ProfileImageUrl | string |
URL da imagem de perfil |
OriginalTweetUserMentionsModel
Representa um usuário mencionado em um tweet original.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tweet original mencionado id do usuário
|
Id | integer |
ID X (identificador) do usuário |
|
Tweet original mencionado nome completo do usuário
|
FullName | string |
Nome completo do usuário |
|
Tweet original mencionado nome de usuário
|
UserName | string |
Nome de tela do usuário |
OriginalTweetUserDetailsModel
Representa um usuário que postou um tweet original
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome completo do usuário do tweet original
|
FullName | string |
Nome do utilizador |
|
Local do usuário do tweet original
|
Location | string |
Localização do usuário |
|
ID do usuário do tweet original
|
Id | integer |
ID X (identificador) do usuário |
|
Nome de usuário do tweet original
|
UserName | string |
Nome de tela do usuário |
|
Contagem original de seguidores do usuário de tweet
|
FollowersCount | integer |
Número de seguidores |
|
Descrição do usuário do tweet original
|
Description | string |
Descrição do usuário |
|
Contagem de status do usuário do tweet original
|
StatusesCount | integer |
Contagem de status do usuário |
|
Contagem original de amigos do usuário do tweet
|
FriendsCount | integer |
Número de amigos |
|
Contagem original de favoritos do usuário de tweet
|
FavouritesCount | integer |
Número de tweets que o usuário tem favoritos |
|
URL da imagem de perfil do usuário do tweet original
|
ProfileImageUrl | string |
URL da imagem de perfil |
TweetResponseModel
Representa a resposta de uma postagem de tweet.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do tweet
|
TweetId | string |
ID do tweet postado |
TriggerBatchResponse[TweetModel]
Representa um objeto wrapper para a resposta do gatilho em lotes
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of TweetModel |
Uma lista dos objetos de resposta |