Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
# CiviCRM MessageMedia SMS Extension
> MessageMedia Account
You will need an account with MessageMedia to use this plugin. You can join MessageMedia with discounted pricing via this link: https://messagemedia.com/au/civicrm/
Once logged into MessageMedia dashboard, navigate to:
Configuration -> API Settings -> Basic Authentication
Click create new key
Call the new API key "CiviCRM".
Copy the api_key and api_secret. Once the window is closed, these keys will no longer be visible in the MessageMedia web site. If you lose these keys, you'll need to re-generate them. These keys will be pasted in CiviCRM when setting up the SMS gateway.
They will be in the format:
```
[CiviCRM]
api_key = xxxxxx
api_secret = xxxxxx
```
> CiviCRM Extension Setup
When logged into CiviCRM as an Administrator, navigate to: Administrator -> System Settings -> SMS Providers.
Click to add a new SMS Provider.
Enter the details as follows:
```
Name: Message Media
Title: Message Media
Username = api_key
Password= api_secret
API Type: http
API URL: https://soap.m4u.com.au/?wsdl
API Parameters:
Is this provider active?: True
Is this a default provider?: True (Assumes not using another SMS extension)
```
If using a dedicated number to send an SMS, enter the number in the API parameters in a single line:
```
from=+614xxxxxx
```
That's it! The extension is installed and configured.
----
You can set up incoming SMS from Message Media (optional):
Create a new web hook in the Message Media Portal:
Event: SMS, MMS
Method: PUT
URL:
(Wordpress)
https://example.com/civicrm/?civiwp=CiviCRM&q=civicrm/sms/callback&provider=au.com.devapp.messagemedia
(Drupal)
https://example.com/civicrm/sms/callback?provider=au.com.devapp.messagemedia
Select the parameters as follows (each token pair should be a new parameter on a new line)
```
from : $sourceAddress
to : $destinationAddress
id : $mtId
```
Save the web hook.
Send an SMS from CiviCRM and then reply to the message.
Hint: In CiviCRM, ensure the sending SMS number (assigned by Message Media) is attached to a contact in CiviCRM. Otherwise incoming SMS activities will fail to be created. CiviCRM will create an activity for each incoming SMS with the source contact set as the contact matching the MessageMedia mobile number. CiviCRM will assign the activity with contact to the contact with the matching mobile number that replied to the SMS.
> Testing an SMS
Load an existing contact record in CiviCRM, and ensure the contact has a phone number (mobile) entered.
From the actions menu, select "Outbound SMS".
Complete the "Name The SMS" (this is not sent to the contact), and enter the "SMS Message". The message content will be sent to the contact. Select "Send SMS" when ready to send.
If the SMS was sent successfully, a confirmation message will be displayed. A CiviCRM activity will also be created to track the SMS send activity.