Comment WORD for WHATEVER implementation in Mautic.
With this plugin you can define a InstagramDm that is sent to a user when he:
- sends you one of the
triggerWordsas DM - comments on any post with one of the
triggerWords
Every instagram DM can define multiple triggerWords.
When a user starts the process by writing a DM or a comment, the user will be created as contact in Mautic. His instagram handle will then be added to his profile.
The instagram DM can contain links. All of these link clicks and actions will be attributed to this user.
When the instagram DM includes a link to a landing page and the user enters his email, then the profile will be enriched with this data.
Mautic is great for newsletters. If you have an instagram audience and want to grow a newsletter list, this is the perfect match.
The plugin has been developed on a Mautic 6.0 instance and will be maintained for as long as we keep using Mautic.
The current version however is in early development and the API might change. So don't rely on the API for now.
- Register for the instagram API
You wil need a Facebook account. Go to developers and create a new application.
THE APP DOES NOT NEED TO BE REVIEWED TO WORK - If you want to be a person that hosts this for others, then you will need to review it. For your own account, you don't need to review it.
- Copy the instagram client id and the instagram secret
You should find the
Instagram-App-Idand theInstagram-App-Secreton this page:https://developers.facebook.com/apps/<YOURAPP>/instagram-business/API-Setup
Copy them.
- Authorize the app
Go to the plugin administration of Mautic
https://<instance>/s/pluginsand selectMautic Instagram.
Enter those credentials instagram-app-id and instagram-app-secret, that you have copied previously.
Then select a random webhook verify token. This is only needed, so that facebook knows that this endpoint is inteded for facebook webhooks and configured by you. AFTER successfully configuring it, nobody cares anymore about this value.
- Note: Token expiration
The Symfony command to refresh the access token is not implemented yet.
THE ACCESS TOKEN WILL EXPIRE AFTER 60 days. So keep this in mind.
- Facebook app configuration
Go back to facebook and enter the webhook verify token from step 3.
Also select the events that trigger a webhook to this endpoint: comments, messages.
To define a message that is sent to the user with a specific trigger word, expand the Channels dropdown in the navigation.
Go to Instagram DMs and click New.
You can then define a name that is only used for internal purposes.
Then you define the message that will be sent to the user when he writes or comments one of the trigger words. It supports tokens, like page links and asset links. They will also be tracked down to the lead.
MOST IMPORTANT Define trigger words.