fmMMS Webhooks using OttoFMS
OttoFMS from Proof+Geist can be used to receive incoming messages from your MMS Gateway. You will need to make a few small modifications to your copy of fmMMS - we've added support for OttoFMS webhooks in v1.25 of fmMMS.
If you're using an earlier version of fmMMS the required changes are outlined on the OttoFMS website here and include creating a new layout, 2 new fields and 1 new script. You can copy/paste the OttoReceiver script from the v1.25 file to your file. Your new OttoReceiver layout (based on the Messages table) should look like this:
In the following example we will show you how to create an Otto webhook to receive incoming MMS messages from the Twilio MMS Gateway (similar to the WebhooksIncomingMessages.php file).
Once you've made the necessary changes you need to register a new webhook in the OttoFMS web console - follow the instructions here to register a new webhook.
When registering the new webhook for the fmMMS file you can use the same FileMaker account that the WebhooksIncomingMessages.php file uses here as it has the required access privileges for receiving incoming webhooks via the Data API.
When registering a new webhook you'll first be prompted to select your FileMaker file and enter the FileMaker Username and Password to use:
The webhook you create should look like the following screenshot:
Once you've registered the new webhook the OttoFMS Webhook Registry should look like this:
Once you've registered the webhook click the three dots icon to the right of the webhook entry and select View/Test to view the webhook, then click the copy button to copy the Webhook URL. The Webhook URL should look something like this:
https://otto-server-url/otto/receiver/fmMMS.fmp12/fmmms?apiKey=dk_UNlsC1xffmQkaXN83tIaLu6BfevAmKCi
You now need to enter the Otto webhook URL in your MMS Gateway account. The process for this will be different for each MMS Gateway - you can get more information for your MMS Gateway on the MMS Gateways page or by contact your selected MMS Gateway.
You now need to test the webhook by sending a message from your phone to your Gateway number to simulate an incoming MMS message - it should create a new record on the OttoReceiver layout and populate the Payload field with the content of the incoming message and then populate the appropriate fields with the data from the payload, as well as create any media attachments that were sent with the message. If you look at the same record on the Messages Form layout you should see the the new record with the appropriate data in the Contact, Message Body, Media fields etc.
As the OttoReceiver script in v1.25 of the fmMMS file is designed to process incoming messages from the Twilio MMS Gateway you will need to modify the OttoReceiver script to process incoming messages from other supported MMS Gateways.
If you will be receiving incoming messages from more than one MMS Gateway we recommend creating Otto webhooks for each MMS Gateway and setting the Channel value in the webhook URL to the name of the MMS Gateway. You can then branch in the OttoReceiver script for each MMS Gateway by referencing the value in the Channel field.