X
X, anteriormente conocido como Twitter, es un servicio de redes sociales en línea que permite a los usuarios enviar y recibir publicaciones breves. Conéctese a X para administrar sus publicaciones. Puede realizar diversas acciones, como enviar publicaciones, buscar, ver seguidores, etc.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - China Cloud operado por 21Vianet |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - China Cloud operado por 21Vianet |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - China Cloud operado por 21Vianet |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL |
Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Website | https://x.com/ |
| Directiva de privacidad | https://x.com/privacy |
Autenticación y traiga su propia aplicación
Importante
La aplicación compartida predeterminada (aplicación cliente de Twitter mantenida por Microsoft) ya no está disponible. El conector ahora solo admite un tipo de autenticación: Traiga su propia aplicación. A partir de junio de 2023, requiere una aplicación de nivel Enterprise de pago. Sin embargo, la directiva de precios de Twitter podría seguir modificando.
Con la opción "Traiga su propia aplicación", puede usar su propia aplicación cliente de Twitter OAuth. Esto le permite controlar los permisos y habilitar ciertas limitaciones en el uso del conector.
Para usar su propia aplicación cliente de Twitter OAuth con el conector de Twitter, deberá realizar los pasos siguientes:
- Creación de una aplicación cliente de OAuth mediante la página para desarrolladores de Twitter (https://developer.twitter.com)
- Uso de la aplicación en el conector de Twitter
Creación de una aplicación cliente de OAuth en Twitter
Para crear su propia aplicación cliente de Twitter OAuth, primero deberá iniciar sesión en https://developer.twitter.com. Vaya a la sección "Proyectos y aplicaciones", donde puede administrar y crear aplicaciones de Twitter. Este proceso se explica en la Guía para desarrolladores de Twitter de Twitter. Después de crear la aplicación de Twitter en la página para desarrolladores , se requieren los pasos siguientes para la configuración correcta:
- Selección de la aplicación de Twitter
- Edite los permisos de la aplicación para habilitar la lectura y escritura.
- Edición de la configuración de autenticación
- Habilitación de la autenticación de terceros
- Agregue
https://global.consent.azure-apim.net/redirectpara las direcciones URL de devolución de llamada (NOTA: Si usa la suscripción de Fairfax o el entorno GCC, consulte la sección "Devoluciones de llamada de Fairfax y GCC") - Establezca "Dirección URL del sitio web" (campo obligatorio, pero su valor no afecta al flujo).
Devoluciones de llamada fairfax y GCC
Si usa la suscripción de Fairfax o el entorno de GCC, agregue las siguientes direcciones URL para las direcciones URL de devolución de llamada de la aplicación de 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
Una vez que haya terminado, seleccione la aplicación de Twitter y vaya a la página "Claves y tokens". En la sección "Claves de consumidor", haga clic en el botón "Ver claves" para obtener la clave de API y el secreto de clave de API de la aplicación. Ahora puede usar esos valores en la conexión de Twitter.
Uso de su propia aplicación en el conector de Twitter
Una vez creada la aplicación cliente de OAuth de Twitter, puede usarla al crear una conexión de Twitter.
- Seleccione Bring your own application (Traiga su propia aplicación).
- Especifique los valores id. de cliente y secreto de cliente de la aplicación. (Use la clave de API y el secreto de clave de API de la aplicación de Twitter)
Haga clic en Iniciar sesión para iniciar sesión en su cuenta de Twitter. Esto le pedirá que inicie sesión en su cuenta de Twitter y, a continuación, autorice el acceso a la aplicación de Twitter que creó anteriormente.
LÍMITES
A continuación se muestran algunos de los límites y restricciones:
- Número máximo de conexiones por usuario: 2
- Límite de frecuencia de llamadas api para la operación POST: 12 por hora
- Límite de frecuencia de llamadas api para otras operaciones: 600 por hora
- Frecuencia de sondeos de desencadenador: 1 hora
- Tamaño máximo de carga de imágenes: 5 MB
- Tamaño máximo de carga de vídeo: 15 MB
- Número máximo de resultados de búsqueda: 100
- Número máximo de tweets nuevos de los que se realiza un seguimiento dentro de un intervalo de sondeo: 5
- La longitud máxima permitida del valor del parámetro "Texto de búsqueda" es 470
Restricciones de la API de Twitter
- Search API busca en un muestreo de tweets recientes publicados en los últimos 7 días
- La API de búsqueda estándar se centra en la relevancia y no en la integridad. Esto significa que algunos tweets y usuarios pueden faltar en los resultados de búsqueda.
Restricciones adicionales para la operación POST
No se admite la mención de un @user mensaje al publicar un tweet. En concreto, los caracteres "@" se quitarán al publicar un tweet.
Límites generales
| Nombre | Importancia |
|---|---|
| Conexiones por cuenta | 2 |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Traiga su propia aplicación | Inicie sesión con su propia aplicación de Twitter. Para obtener más información, consulte la sección "Autenticación y traiga su propia aplicación" en esta página. | Todas las regiones | No se puede compartir |
| Valor predeterminado [EN DESUSO] | Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. | Todas las regiones | No se puede compartir |
Traiga su propia aplicación
Identificador de autenticación: byoa
Aplicable: Todas las regiones
Inicie sesión con su propia aplicación de Twitter. Para obtener más información, consulte la sección "Autenticación y traiga su propia aplicación" en esta página.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de consumidor | cuerda / cadena | Clave de consumidor de la aplicación de Twitter | Cierto |
| Secreto de consumidor | securestring | Secreto de cliente de la aplicación de Twitter | Cierto |
Valor predeterminado [EN DESUSO]
Aplicable: Todas las regiones
Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Acciones
| Buscar tweets |
Esta operación obtiene una lista de tweets relevantes que coinciden con la consulta de búsqueda. |
| Obtención de la escala de tiempo del usuario |
Esta operación obtiene una lista de los tweets más recientes publicados por un usuario determinado. |
| Obtener escala de tiempo de inicio |
Esta operación obtiene los tweets y re-tweets más recientes publicados por mí y mis seguidores. |
| Obtener mis seguidores |
Esta operación obtiene la lista de usuarios que me siguen. |
| Obtener seguidores |
Esta operación obtiene la lista de usuarios que siguen a un usuario determinado. |
| Obtener usuario |
Esta operación obtiene los detalles del perfil de un usuario determinado, como el nombre de usuario, la descripción, el recuento de seguidores, etc. |
| Obtenga lo siguiente: |
La operación obtiene la lista de personas a las que sigue el usuario especificado. |
| Obtenga lo siguiente: |
Esta operación obtiene la lista de usuarios que estoy siguiendo. |
| Publicar un tweet |
Esta operación publica un nuevo tweet. |
| Retweet |
Esta operación retweets un tweet. |
Buscar tweets
Esta operación obtiene una lista de tweets relevantes que coinciden con la consulta de búsqueda.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Buscar texto
|
searchQuery | True | string |
Término de búsqueda como "happy hour", #haiku, from:@username, love OR hate. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de tweets que se van a devolver. |
|
|
sinceId
|
sinceId | string |
Devuelve tweets después del identificador de tweet especificado. |
Devoluciones
- response
- array of TweetModel
Obtención de la escala de tiempo del usuario
Esta operación obtiene una lista de los tweets más recientes publicados por un usuario determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de usuario
|
userName | True | string |
Identificador X para el usuario. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de tweets que se van a devolver. |
Devoluciones
- response
- array of TweetModel
Obtener escala de tiempo de inicio
Esta operación obtiene los tweets y re-tweets más recientes publicados por mí y mis seguidores.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Resultados máximos
|
maxResults | integer |
Número máximo de tweets que se van a devolver. |
Devoluciones
- response
- array of TweetModel
Obtener mis seguidores
Esta operación obtiene la lista de usuarios que me siguen.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuarios que se van a obtener. |
Devoluciones
- response
- array of UserDetailsModel
Obtener seguidores
Esta operación obtiene la lista de usuarios que siguen a un usuario determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de usuario
|
userName | True | string |
Identificador X para el usuario. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuarios que se van a devolver. |
Devoluciones
- response
- array of UserDetailsModel
Obtener usuario
Esta operación obtiene los detalles del perfil de un usuario determinado, como el nombre de usuario, la descripción, el recuento de seguidores, etc.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de usuario
|
userName | True | string |
Identificador X para el usuario. |
Devoluciones
Representa un usuario.
- Body
- UserDetailsModel
Obtenga lo siguiente:
La operación obtiene la lista de personas a las que sigue el usuario especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de usuario
|
userName | True | string |
Identificador X para el usuario. |
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuarios que se van a devolver. |
Devoluciones
- response
- array of UserDetailsModel
Obtenga lo siguiente:
Esta operación obtiene la lista de usuarios que estoy siguiendo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Resultados máximos
|
maxResults | integer |
Número máximo de usuarios que se van a devolver. |
Devoluciones
- response
- array of UserDetailsModel
Publicar un tweet
Esta operación publica un nuevo tweet.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Texto del tweet
|
tweetText | string |
Texto que se va a publicar. |
|
|
Medios de comunicación
|
body | binary |
Medios que se van a publicar. |
Devoluciones
Representa la respuesta de una publicación de tweet.
- Body
- TweetResponseModel
Retweet
Esta operación retweets un tweet.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de tweet
|
tweetId | True | string |
Tweet que se va a retweetear. |
|
Recorte del usuario
|
trimUser | boolean |
Boolean para indicar si se va a recortar la información del usuario. |
Devoluciones
Representa la respuesta de una publicación de tweet.
- Body
- TweetResponseModel
Desencadenadores
| Cuando se publica un tweet nuevo |
Esta operación desencadena un flujo cuando se publica un nuevo tweet que coincide con una consulta de búsqueda determinada. |
Cuando se publica un tweet nuevo
Esta operación desencadena un flujo cuando se publica un nuevo tweet que coincide con una consulta de búsqueda determinada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Buscar texto
|
searchQuery | True | string |
Término de búsqueda como "happy hour", #haiku, from:@username, love OR hate. |
Devoluciones
Representa un objeto contenedor para la respuesta del desencadenador por lotes.
Definiciones
TweetModel
Representa una publicación de tweet.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Texto del tweet
|
TweetText | string |
Contenido de texto del tweet |
|
Id. de tweet
|
TweetId | string |
Id. del tweet |
|
Creado en
|
CreatedAtIso | string |
Hora en la que se publicó el tweet |
|
Recuento de retweet
|
RetweetCount | integer |
Número total de re-tweets para el tweet |
|
Tweeted by
|
TweetedBy | string |
Nombre del usuario que ha publicado el tweet |
|
Direcciones URL de medios
|
MediaUrls | array of string |
Dirección URL de los medios publicados junto con el tweet |
|
Idioma del tweet
|
TweetLanguageCode | string |
Código de idioma del tweet |
|
in_reply_to_user_id
|
TweetInReplyToUserId | string |
Identificador de usuario del autor del tweet al que responde el tweet actual |
|
Favorito
|
Favorited | boolean |
Indica si el tweet está marcado como favorito o no. |
|
Menciones de usuario
|
UserMentions | array of UserMentionsModel |
Lista de usuarios mencionados en el tweet |
|
OriginalTweet
|
OriginalTweet | OriginalTweetModel |
Representa una publicación de tweet original. |
|
Detalles del usuario
|
UserDetails | UserDetailsModel |
Representa un usuario. |
UserMentionsModel
Representa un usuario mencionado en un tweet.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de usuario mencionado
|
Id | integer |
Identificador X (identificador) del usuario |
|
Nombre completo de usuario mencionado
|
FullName | string |
Nombre completo del usuario |
|
Nombre de usuario mencionado
|
UserName | string |
Nombre de pantalla del usuario |
OriginalTweetModel
Representa una publicación de tweet original.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Texto original del tweet
|
TweetText | string |
Contenido de texto del tweet recuperado original |
|
Id. de tweet original
|
TweetId | string |
Id. del tweet original |
|
Tweet original creado en
|
CreatedAtIso | string |
Hora en la que se publicó el tweet original |
|
Recuento de retweet de tweet original
|
RetweetCount | integer |
Número total de re-tweets para este tweet original |
|
Tweet original tweeted by
|
TweetedBy | string |
Nombre de usuario de la persona que publicó el tweet original |
|
Direcciones URL de medios de tweet originales
|
MediaUrls | array of string |
Dirección URL de los medios publicados junto con el tweet original |
|
Idioma original del tweet
|
TweetLanguageCode | string |
Código de idioma para el tweet original |
|
In_reply_to_user_id de tweet original
|
TweetInReplyToUserId | string |
Identificador de usuario del autor del tweet al que responde el tweet original actual |
|
Tweet original favorito
|
Favorited | boolean |
Indica si el tweet original está marcado como favorito. |
|
Menciones de usuario de tweet originales
|
UserMentions | array of OriginalTweetUserMentionsModel |
Lista de usuarios mencionados en el tweet |
|
Detalles del usuario
|
UserDetails | OriginalTweetUserDetailsModel |
Representa un usuario que publicó un tweet original. |
UserDetailsModel
Representa un usuario.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
FullName | string |
Nombre del usuario |
|
Ubicación
|
Location | string |
Ubicación del usuario |
|
Id. de usuario
|
Id | integer |
Identificador X (identificador) del usuario |
|
Nombre de usuario
|
UserName | string |
Nombre de pantalla del usuario |
|
Recuento de seguidores
|
FollowersCount | integer |
Número de seguidores |
|
Description
|
Description | string |
Descripción del usuario |
|
Recuento de estados
|
StatusesCount | integer |
Recuento de estado de usuario |
|
Recuento de amigos
|
FriendsCount | integer |
Número de amigos |
|
Recuento de favoritos
|
FavouritesCount | integer |
Número de tweets que el usuario ha favorito |
|
Dirección URL de la imagen de perfil
|
ProfileImageUrl | string |
Dirección URL de la imagen de perfil |
OriginalTweetUserMentionsModel
Representa un usuario mencionado en un tweet original.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Tweet original mencionado identificador de usuario
|
Id | integer |
Identificador X (identificador) del usuario |
|
Tweet original mencionado nombre completo de usuario
|
FullName | string |
Nombre completo del usuario |
|
Tweet original mencionado nombre de usuario
|
UserName | string |
Nombre de pantalla del usuario |
OriginalTweetUserDetailsModel
Representa un usuario que publicó un tweet original.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre completo del usuario del tweet original
|
FullName | string |
Nombre del usuario |
|
Ubicación original del usuario del tweet
|
Location | string |
Ubicación del usuario |
|
Id. de usuario del tweet original
|
Id | integer |
Identificador X (identificador) del usuario |
|
Nombre de usuario del tweet original
|
UserName | string |
Nombre de pantalla del usuario |
|
Recuento original de seguidores de usuarios de tweet
|
FollowersCount | integer |
Número de seguidores |
|
Descripción del usuario del tweet original
|
Description | string |
Descripción del usuario |
|
Recuento de estados de usuario de tweet originales
|
StatusesCount | integer |
Recuento de estado de usuario |
|
Recuento original de amigos de usuario de tweet
|
FriendsCount | integer |
Número de amigos |
|
Recuento de favoritos del usuario de tweet original
|
FavouritesCount | integer |
Número de tweets que el usuario ha favorito |
|
Dirección URL original de la imagen del perfil de usuario del tweet
|
ProfileImageUrl | string |
Dirección URL de la imagen de perfil |
TweetResponseModel
Representa la respuesta de una publicación de tweet.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de tweet
|
TweetId | string |
Id. del tweet publicado |
TriggerBatchResponse[TweetModel]
Representa un objeto contenedor para la respuesta del desencadenador por lotes.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of TweetModel |
Lista de los objetos de respuesta |