Oracle Content Management Social Media Posting Guide
Getting Started with Ayrshare for Oracle Content Management
Introduction
Congratulations on selecting Ayrshare, the leading social media publishing API platform to complement your Oracle Content Management (OCM) subscription.
This guide explains how to configure your OCM product to let you publish content to your company’s social media accounts.
As part of your Ayrshare subscription, you have a white-glove implementation available. Please contact us at [email protected] if you would like an implementation specialist to configure Ayrshare and OCM on your behalf. If you prefer to do the setup yourself, please follow the instructions below.
Setup
Before you can start posting content to social media networks, you need to create your Ayrshare account and configure OCM.
Step 1: Set up Ayrshare account
Go to app.ayrshare.com and create a new account. Choose “Sign in with email” and use the email address associated with the primary user.
One you are logged in, go to the API Key section, and note your API Key. You can always come back to this page if you want to find your API Key in the future.
Step 2: Link your social media accounts in Ayrshare
Go to the Social Accounts section. Click on each social network that you want to connect. Each social network will ask you for permission to connect, which you can accept.
You will see “Linked” and your profile image on each tile that you have connected.
Step 3: Set up a new Asset type in OCM
In the OCM Administration section, go to the Content section. Select Asset Types, and click the Create button.
You will add 4 data fields to the Content Type Definition.
It is important to use the exact field names that are in this guide for the integration to work correctly. Capitalization is disregarded, but the spelling must match.
| Post | Text | Single | Yes | Appearance of data field = Text Area |
| Media | Media | Multiple | No | Appearance of data field = Media Picker Select media = Images and Videos Check All digital asset types |
| Date | Date | Single | No | Appearance of data field = Date/Time Picker |
| Platforms | Text | Multiple | Yes | Appearance of data field = CheckboxesEnter the Options for the social networks that you linked in Step 2 above. Acceptable values are: "facebook", "fbg", "twitter", "linkedin", "instagram", "youtube", "reddit", "telegram", "gmb", "pinterest", or "tiktok"See below example image. |
Step 4: Create a Publishing Channel in OCM
In the Administration -> Content section of OCM, create a new Publishing Channel. You can name it something like “Ayrshare Social Publishing Channel”.
Step 5: Create a Asset Repository in OCM
In the Administration -> Content section of OCM, create a new Repository. You can select the Asset Type you created in Step 3, and the Channel you created in Step 4. You can name it something like “Ayrshare Repository”.
Step 6: Add the Ayrshare Webhook
In the Administration -> Integrations section of OCM, create a new Webhook. Select “Asset Publishing Webhook” as the type when prompted.
As you can see in the image below, give it a name, select the Publishing Channel from Step 4, and enter the below Target URL. In the Authentication section, select Header, an add details as per the image below. The key is "Authorization" and the value is "Bearer YOURAPIKEY". Remember to add the word "Bearer" and a space before your API Key which you copied in Step 1 above.
https://app.ayrshare.com/api/hook/oracle
Step 7: Send Channel Token
The last step is to send your OCM channel token to Ayrshare. Before your posts can go live on the social networks, you need to create a post, and publish it to Ayrshare to find your channel token.
You can find the channel token in the Administration -> Content -> Publishing Channels section. Click the channel you created and then expand the right panel and select the API tab.
Copy this channel token and send it to your Ayrshare representative or [email protected].
Publishing
Once the setup is complete, you can post to your linked social media accounts.
In OCM, go to the Assets section and ensure that your new Repository that was created in Step 5 is active.
Create a new content item of the type you created in Step 3.
Fill out the details of the social media post. Add the post body text, media assets if applicable, scheduled date and time if applicable, and platforms.
Add a channel, which should be the one you created in Step 4.
You can click Publish to validate the post, and then click Publish to send the post to the social networks
Some Tips
- If you pass additional fields since you use the same content with other channels, the Ayrshare system will disregard them. This should not impact the social media posts.
- You can add additional fields that are specific to certain social networks. For example, for YouTube you will need to add title and visibility fields. You can contact Ayrshare support to get more information on social network-specific fields.
- Certain social networks require a media asset. For example, Instagram will not take a text-only post. You can see any errors in the Ayrshare dashboard in the Posts section.
- If you do not send a date/time then the post will be published to the social networks immediately.
- If your image is not shown in the live social media post, it may be because the image was previously processed by OCM. Try uploading the image as a new asset from your computer when you create the post.
Managing Posts
To see the status of published posts, check the Ayrshare dashboard at app.ayrshare.com in the Posts section.
Also from this dashboard, you can see the history of your posts and delete posts if needed.
