Merge pull request #49981 from ecfan/metadata-1

Update metadata and content for Twitter connector

Author: ktoliver

articles/connectors/connectors-create-api-twitter.md

@@ -1,101 +1,122 @@
 ---
-title: Learn how to use the Twitter connector in logic apps | Microsoft Docs
-description: Overview of Twitter connector with REST API parameters
-services: ''
-documentationcenter: ''
+title: Connect to Twitter from Azure Logic Apps | Microsoft Docs
+description: Automate tasks and workflows that monitor and manage tweets, plus get data about followers, your followed users, other users, timelines, and more from your Twitter account by using Azure Logic Apps
+services: logic-apps
+ms.service: logic-apps
+ms.suite: integration
 author: ecfan
-manager: jeconnoc
-editor: ''
-tags: connectors
-
+ms.author: estfan
+ms.reviewer: klam, LADocs
 ms.assetid: 8bce2183-544d-4668-a2dc-9a62c152d9fa
-ms.service: multiple
-ms.devlang: na
 ms.topic: article
-ms.tgt_pltfrm: na
-ms.workload: na
-ms.date: 07/18/2016
-ms.author: estfan; ladocs
-
+tags: connectors
+ms.date: 08/25/2018
 ---
-# Get started with the Twitter connector
-With the Twitter connector you can:
 
-* Post tweets and get tweets
-* Access timelines, friends, and followers
-* Perform any of the other actions and triggers described in this article
+# Monitor and manage Twitter by using Azure Logic Apps
+
+With Azure Logic Apps and the Twitter connector, 
+you can create automated tasks and workflows that monitor 
+and manage data you care about in Twitter such as tweets, 
+followers, users and followed users, timelines, and more, 
+along with other actions, for example:
+
+* Monitor, post, and search tweets.
+* Get data such as followers, followed users, timelines, and more.
+
+You can use triggers that get responses from your Twitter account 
+and make the output available to other actions. You can use actions 
+that perform tasks with your Twitter account. You can also have 
+other actions use the output from Twitter actions. For example, 
+when a new tweet with a specific hashtag appears, you can send 
+messages with the Slack connector. If you're new to logic apps, 
+review [What is Azure Logic Apps?](../logic-apps/logic-apps-overview.md)
+
+## Prerequisites
+
+* An Azure subscription. If you don't have an Azure subscription, 
+<a href="https://azure.microsoft.com/free/" target="_blank">sign up for a free Azure account</a>. 
 
-To use [any connector](apis-list.md), you first need to create a logic app. You can get started by [creating a logic app now](../logic-apps/quickstart-create-first-logic-app-workflow.md).  
+* Your Twitter account and user credentials
+
+   Your credentials authorize your logic app to create 
+   a connection and access your Twitter account.
+
+* Basic knowledge about 
+[how to create logic apps](../logic-apps/quickstart-create-first-logic-app-workflow.md)
+
+* The logic app where you want to access your Twitter account. 
+To start with a Twitter trigger, [create a blank logic app](../logic-apps/quickstart-create-first-logic-app-workflow.md). 
+To use a Twitter action, start your logic app with another trigger, 
+for example, the **Recurrence** trigger.
 
 ## Connect to Twitter
-Before your logic app can access any service, you first need to create a *connection* to the service. A [connection](connectors-overview.md) provides connectivity between a logic app and another service.  
-
-### Create a connection to Twitter
-> [!INCLUDE [Steps to create a connection to Twitter](../../includes/connectors-create-api-twitter.md)]
-> 
-> 
-
-## Use a Twitter trigger
-A trigger is an event that can be used to start the workflow defined in a logic app. [Learn more about triggers](../logic-apps/logic-apps-overview.md#logic-app-concepts).
-
-In this example, you use the **When a new tweet is posted**  trigger to search for #Seattle. And if #Seattle is found, update a file in Dropbox with the text from the tweet. In an enterprise example, you could search for the name of your company and update a SQL database with the text from the tweet.
-
-1. Enter *twitter* in the search box on the logic apps designer then select the **Twitter - When a new tweet is posted**  trigger   
-   ![Twitter trigger image 1](./media/connectors-create-api-twitter/trigger-1.png)  
-2. Enter *#Seattle* in the **Search Text** control  
-   ![Twitter trigger image 2](./media/connectors-create-api-twitter/trigger-2.png) 
-
-At this point, your logic app has been configured with a trigger that will begin a run of the other triggers and actions in the workflow. 
-
-> [!NOTE]
-> For a logic app to be functional, it must contain at least one trigger and one action. Use the steps in the next section to add an action.
-
-## Add a condition
-We are only interested in tweets from users with more than 50 users. So, a condition that confirms the number of followers is added to the logic app first.  
-
-1. Select **+ New step** to add the action you would like to take when #Seattle is found in a new tweet  
-   ![Twitter action image 1](../../includes/media/connectors-create-api-twitter/action-1.png)  
-2. Select the **Add a condition** link.  
-   ![Twitter condition image 1](../../includes/media/connectors-create-api-twitter/condition-1.png)   
-   This opens the **Condition** control where you can check conditions such as *is equal to*, *is less than*, *is greater than*, *contains*, etc.  
-   ![Twitter condition image 2](../../includes/media/connectors-create-api-twitter/condition-2.png)   
-3. Select the **Choose a value** control. In this control, you can select one or more of the properties from any previous actions or triggers. The condition of this property value is evaluated to true or false.
-   ![Twitter condition image 3](../../includes/media/connectors-create-api-twitter/condition-3.png)   
-4. Select the **...** to expand the list of properties so you can see all the properties that are available.        
-   ![Twitter condition image 4](../../includes/media/connectors-create-api-twitter/condition-4.png)   
-5. Select the **Followers count** property.    
-   ![Twitter condition image 5](../../includes/media/connectors-create-api-twitter/condition-5.png)   
-6. Notice the Followers count property is now in the value control.    
-   ![Twitter condition image 6](../../includes/media/connectors-create-api-twitter/condition-6.png)   
-7. Select **is greater than** from the operators list.    
-   ![Twitter condition image 7](../../includes/media/connectors-create-api-twitter/condition-7.png)   
-8. Enter 50 as the operand for the *is greater than* operator.  
-   The condition is now added. Save your work using the **Save** link on the menu.    
-   ![Twitter condition image 8](../../includes/media/connectors-create-api-twitter/condition-8.png)   
-
-## Use a Twitter action
-An action is an operation carried out by the workflow defined in a logic app. [Learn more about actions](../logic-apps/logic-apps-overview.md#logic-app-concepts).  
-
-Now that there's a trigger, add an action that posts a new tweet with the contents of the tweets found by the trigger. For this walk-through, only tweets from users with more than 50 followers are posted.  
-
-In the next step, add a Twitter action that posts a tweet using some of the properties of each tweet that is posted by a user with more than 50 followers.  
-
-1. Select **Add an action**. This step opens the search control where you can search for other actions and triggers.  
-   ![Twitter condition image 9](../../includes/media/connectors-create-api-twitter/condition-9.png)   
-2. Enter *twitter* into the search box then select the **Twitter - Post a tweet** action. This step opens the **Post a tweet** control where you enter all details for the tweet being posted.      
-   ![Twitter action image 1-5](../../includes/media/connectors-create-api-twitter/action-1-5.png)   
-3. Select the **Tweet text** control. All outputs from previous actions and triggers in the logic app are now visible. You can select any of these outputs, and use them as part of the tweet text of the new tweet.     
-   ![Twitter action image 2](../../includes/media/connectors-create-api-twitter/action-2.png)   
-4. Select **User name**   
-5. Immediately after User name, enter *says:* in the tweet text control.
-6. Select *Tweet text*.       
-   ![Twitter action image 3](../../includes/media/connectors-create-api-twitter/action-3.png)   
-7. To activate your workflow, save your work, and send a tweet with the #Seattle hashtag.
-
-
-## Connector-specific details
-
-View any triggers and actions defined in the swagger, and also see any limits in the [connector details](/connectors/twitterconnector/). 
+
+[!INCLUDE [Create connection general intro](../../includes/connectors-create-connection-general-intro.md)]
+
+1. Sign in to the [Azure portal](https://portal.azure.com), 
+and open your logic app in Logic App Designer, if not open already.
+
+1. Choose a path: 
+
+   * For blank logic apps, in the search box, 
+   enter "twitter" as your filter. 
+   Under the triggers list, select the trigger you want. 
+
+     -or-
+
+   * For existing logic apps: 
+   
+     * Under the last step where you want to add an action, 
+     choose **New step**. 
+
+       -or-
+
+     * Between the steps where you want to add an action, 
+     move your pointer over the arrow between steps. 
+     Choose the plus sign (**+**) that appears, 
+     and then select **Add an action**.
+     
+       In the search box, enter "twitter" as your filter. 
+       Under the actions list, select the action you want.
+
+1. If you're prompted to sign in to Twitter, 
+sign in now so you can authorize access for your logic app.
+
+1. Provide the necessary details for your selected trigger 
+or action and continue building your logic app's workflow.
+
+## Examples
+
+### Twitter trigger: When a new tweet is posted
+
+This trigger starts a logic app workflow when the trigger detects 
+a new tweet, for example, with the hashtag, #Seattle. So for example, 
+when these tweets are found, you can add a file with the tweets' 
+contents to storage, such as a Dropbox account by using the Dropbox connector. 
+
+Optionally, you can include a condition that eligible tweets 
+must come from users with at least a specified number of followers.
+
+**Enterprise example**: You can use this trigger to monitor tweets 
+about your company and upload the tweets' content to a SQL database.
+
+### Twitter action: Post a tweet
+
+This action posts a tweet, but you can set up the action so that the tweet 
+contains the content from tweets found by the previously described trigger. 
+
+## Connector reference
+
+For technical details about triggers, actions, and limits, which are 
+described by the connector's OpenAPI (formerly Swagger) description, 
+review the connector's [reference page](/connectors/twitterconnector/).
+
+## Get support
+
+* For questions, visit the [Azure Logic Apps forum](https://social.msdn.microsoft.com/Forums/en-US/home?forum=azurelogicapps).
+* To submit or vote on feature ideas, visit the [Logic Apps user feedback site](http://aka.ms/logicapps-wish).
 
 ## Next steps
-[Create a logic app](../logic-apps/quickstart-create-first-logic-app-workflow.md)
+
+* Learn about other [Logic Apps connectors](../connectors/apis-list.md)