Add initial docs for Threads - #13

Author: jamesread

pages/providers/threads.mdx

@@ -0,0 +1,97 @@
+---
+title: Threads
+description: How to add Threads
+---
+
+import {Steps, Callout} from "nextra/components";
+
+<Callout>
+This integration requires that you have setup a Facebook developer account already. You can start by going to the [Meta/Facebook Developer Portal](https://developers.facebook.com/apps).
+
+This is a very complex integration, and it may take some time to get it right. If you have any issues, please reach out to us on the Postiz Discord. This documentation is not yet complete sadly, because at the time of writing the Threads API seems like it's having issues. This page was written to get something up to get you started.
+</Callout>
+
+<Steps>
+### Create an app
+
+Go to the [Meta/Facebook Developer Portal](https://developers.facebook.com/apps) and click on "Create app".
+
+![Create app](./threads_create_app.png)
+
+
+### Give your app a name and email
+
+![Create app](./threads_app_name.png)
+
+### Request access to Threads
+
+Select *Access the Threads API*.
+
+![Request access](./threads_request_api.png)
+
+### Add business details, or skip
+
+![Add business details](./threads_business.png)
+
+### Finish creating the app
+
+You should not have any extra requirements to publish and maintain access.
+
+### Configure API access
+
+On the app dashboard, Select "Access the Threads API" to begin customizing the API access.
+
+Add the "threads_content_publish" and "threads_basic" (automatically selected) to your app.
+
+![Configure API access](./threads_access.png)
+
+### Set threads API settings
+
+* Copy your "Threads App ID", and set the postiz environment variables `THREADS_APP_ID` to this value.
+* Click the "Show" button next to the Threads App Secret, and set the postiz environment variable `THREADS_APP_SECRET` to this value. Note that the next box is quite small, make sure you scroll across the copy the full value. It should be 32 characters long.
+* Set the redirect URL to `https://postiz.example.com/integrations/social/threads` if you are running Postiz on `postiz.example.com`, or `http://localhost:4200/integrations/social/threads` if you are running on `localhost:4200`.
+** Note that you have to "click" the URL to make it active, otherwise the form will not save.
+** You can use the same value for the **Uninstall Callback URL** and **Delete Callback URL**, but note that Postiz does not support either at this time. The form will not save unless you enter something.
+
+![Set threads API settings](./threads_api_settings.png)
+
+On the dashboard view of the Facebook developers portal, make sure you click through the setup wizard to finish the step "Yes I am finished creating the app" to complete the setup. The AP may not work until you've done this.
+
+### Restart Postiz
+
+Stop Postiz if it is running, and then start it again to pick up the new environment variables.
+
+You should not try to add a Threads account to Postiz at this time.
+
+### Add the Threads account as a tester 
+
+* In the sidebar go to "App roles" -> "roles". 
+* Select the "Testers" tab. Click "Add People". 
+* Under *Additional Roles for this App*, select *Threads Tester*.
+* Enter usernames of the threads users you want to test the app. Probably your own username. Note that this is probably different from your Meta developers account which is tied to Facebook.
+
+### Allow the app on your threads account
+
+* On threads.net, open your account settings; https://www.threads.net/settings/account
+* Open *Website permissions*, and switch to the *Invitations* tab;
+* If all has gone well, you should have a pending invite. Accept that invite.
+
+![Threads invite](./threads_invite.png)
+
+### Start testing
+
+* Go back to the Meta developers portal, and in the sidebar, click *Testing*, and then open the *Open Graph API Explorer*. 
+* In the header, dropdown the API selector and change it to threads.net v1. 
+
+![API Version](./threads_api_version.png)
+
+* In the right sidebar, under *Access Token*, click *Generate Threads Access Token*. This will open a new window where you can select the Threads account you want to test with - it should be an account that accepted the earlier invite. 
+
+### ...Good luck!
+
+This documentation is not yet complete sadly, because at the time of writing the Threads API seems like it's having issues. This page was written to get something up to get you started.
+
+This is a very complex integration, and it may take some time to get it right. If you have any issues, please reach out to us on the Postiz Discord.
+
+</Steps>
+