add messages api samples

Author: maxkahan

.env.dist

@@ -11,28 +11,37 @@ FROM_NUMBER='EXAMPLE_FROM_NUMBER'
 VONAGE_BRAND_NAME='Acme Inc.'
 VONAGE_FB_SENDER_ID='YOUR_FB_MESSENGER_SENDER_ID'
 FB_RECIPIENT_ID='YOUR_FB_MESSENGER_RECIPIENT_ID'
-WHATSAPP_NUMBER='YOUR_WHATSAPP_NUMBER'
 CATALOG_ID='YOUR_CATALOG_ID'
 PRODUCT_RETAILER_ID='YOUR_PRODUCT_RETAILER_ID'
 VIBER_SERVICE_MESSAGE_ID='YOUR_VIBER_SERVICE_MESSAGE_ID'
 AUDIO_URL='EXAMPLE_AUDIO_URL'
 IMAGE_URL='EXAMPLE_IMAGE_URL'
 FILE_URL='EXAMPLE_FILE_URL'
 VIDEO_URL='EXAMPLE_VIDEO_URL'
+VCARD_URL='EXAMPLE_VCARD_URL'
+STICKER_ID='EXAMPLE_STICKER_ID'
+STICKER_URL='EXAMPLE_STICKER_URL'
 WHATSAPP_TEMPLATE_REPLACEMENT_TEXT='EXAMPLE_TEMPLATE_REPLACEMENT_TEXT'
 RCS_SENDER_ID='YOUR_RCS_SENDER_ID'
+MESSAGE_UUID='YOUR_MESSAGE_UUID'
+GEOSPECIFIC_VONAGE_API_HOST='api-eu.vonage.com'
+WHATSAPP_NUMBER='YOUR_WHATSAPP_NUMBER'
+WHATSAPP_TEMPLATE_NAMESPACE='YOUR_WHATSAPP_TEMPLATE_NAMESPACE'
+WHATSAPP_TEMPLATE_NAME='YOUR_WHATSAPP_TEMPLATE_NAME'
+WHATSAPP_AUTH_TEMPLATE_NAME='YOUR_WHATSAPP_AUTH_TEMPLATE_NAME'
 
-## Messages Sandbox
-MESSAGES_SANDBOX_URL=
-MESSAGES_SANDBOX_WHATSAPP_NUMBER=
-MESSAGES_SANDBOX_ALLOW_LISTED_TO_NUMBER=
-MESSAGES_SANDBOX_FB_ID=
-MESSAGES_SANDBOX_ALLOW_LISTED_FB_RECIPIENT_ID=
-MESSAGES_SANDBOX_VIBER_SERVICE_ID=
+# Messages Sandbox
+MESSAGES_SANDBOX_URL='YOUR_SANDBOX_URL'
+MESSAGES_SANDBOX_FB_ID='YOUR_SANDBOX_FB_ID'
+MESSAGES_SANDBOX_ALLOW_LISTED_FB_RECIPIENT_ID='ALLOW_LISTED_FB_RECIPIENT_ID'
+MESSAGES_SANDBOX_VIBER_SERVICE_ID='YOUR_SANDBOX_VIBER_SERVICE_ID'
+MESSAGES_SANDBOX_ALLOW_LISTED_TO_NUMBER='ALLOW_LISTED_TO_NUMBER'
+MESSAGES_SANDBOX_WHATSAPP_NUMBER='YOUR_SANDBOX_WHATSAPP_NUMBER'
+MESSAGES_SANDBOX_ALLOW_LISTED_TO_NUMBER='ALLOW_LISTED_TO_NUMBER'
 
 # Signing messages
-VONAGE_SIGNATURE_SECRET=
-VONAGE_SIGNATURE_SECRET_METHOD=
+VONAGE_SIGNATURE_SECRET='YOUR_SIGNATURE_SECRET'
+VONAGE_SIGNATURE_SECRET_METHOD='SIGNATURE_METHOD'
 
 # Verify
 TO_EMAIL='EMAIL_ADDRESS_TO_VERIFY'

messages/mms/send-audio.py

@@ -0,0 +1,33 @@
+import os
+from os.path import join, dirname
+from dotenv import load_dotenv
+
+dotenv_path = join(dirname(__file__), "../../.env")
+load_dotenv(dotenv_path)
+
+VONAGE_APPLICATION_ID = os.environ.get("VONAGE_APPLICATION_ID")
+VONAGE_APPLICATION_PRIVATE_KEY_PATH = os.environ.get(
+    "VONAGE_APPLICATION_PRIVATE_KEY_PATH"
+)
+TO_NUMBER = os.environ.get("TO_NUMBER")
+FROM_NUMBER = os.environ.get("FROM_NUMBER")
+AUDIO_URL = os.environ.get("AUDIO_URL")
+
+from vonage import Auth, Vonage
+from vonage_messages.models import MmsAudio, MmsResource
+
+client = Vonage(
+    Auth(
+        application_id=VONAGE_APPLICATION_ID,
+        private_key=VONAGE_APPLICATION_PRIVATE_KEY_PATH,
+    )
+)
+
+message = MmsAudio(
+    to=TO_NUMBER,
+    from_=FROM_NUMBER,
+    audio=MmsResource(url=AUDIO_URL),
+)
+
+response = client.messages.send(message)
+print(response)

messages/mms/send-image.py

@@ -0,0 +1,33 @@
+import os
+from os.path import join, dirname
+from dotenv import load_dotenv
+
+dotenv_path = join(dirname(__file__), "../../.env")
+load_dotenv(dotenv_path)
+
+VONAGE_APPLICATION_ID = os.environ.get("VONAGE_APPLICATION_ID")
+VONAGE_APPLICATION_PRIVATE_KEY_PATH = os.environ.get(
+    "VONAGE_APPLICATION_PRIVATE_KEY_PATH"
+)
+TO_NUMBER = os.environ.get("TO_NUMBER")
+FROM_NUMBER = os.environ.get("FROM_NUMBER")
+IMAGE_URL = os.environ.get("IMAGE_URL")
+
+from vonage import Auth, Vonage
+from vonage_messages.models import MmsImage, MmsResource
+
+client = Vonage(
+    Auth(
+        application_id=VONAGE_APPLICATION_ID,
+        private_key=VONAGE_APPLICATION_PRIVATE_KEY_PATH,
+    )
+)
+
+message = MmsImage(
+    to=TO_NUMBER,
+    from_=FROM_NUMBER,
+    image=MmsResource(url=IMAGE_URL),
+)
+
+response = client.messages.send(message)
+print(response)

messages/mms/send-vcard.py

@@ -0,0 +1,33 @@
+import os
+from os.path import join, dirname
+from dotenv import load_dotenv
+
+dotenv_path = join(dirname(__file__), "../../.env")
+load_dotenv(dotenv_path)
+
+VONAGE_APPLICATION_ID = os.environ.get("VONAGE_APPLICATION_ID")
+VONAGE_APPLICATION_PRIVATE_KEY_PATH = os.environ.get(
+    "VONAGE_APPLICATION_PRIVATE_KEY_PATH"
+)
+TO_NUMBER = os.environ.get("TO_NUMBER")
+FROM_NUMBER = os.environ.get("FROM_NUMBER")
+VCARD_URL = os.environ.get("VCARD_URL")
+
+from vonage import Auth, Vonage
+from vonage_messages.models import MmsVcard, MmsResource
+
+client = Vonage(
+    Auth(
+        application_id=VONAGE_APPLICATION_ID,
+        private_key=VONAGE_APPLICATION_PRIVATE_KEY_PATH,
+    )
+)
+
+message = MmsVcard(
+    to=TO_NUMBER,
+    from_=FROM_NUMBER,
+    vcard=MmsResource(url=VCARD_URL),
+)
+
+response = client.messages.send(message)
+print(response)

messages/mms/send-video.py

@@ -0,0 +1,33 @@
+import os
+from os.path import join, dirname
+from dotenv import load_dotenv
+
+dotenv_path = join(dirname(__file__), "../../.env")
+load_dotenv(dotenv_path)
+
+VONAGE_APPLICATION_ID = os.environ.get("VONAGE_APPLICATION_ID")
+VONAGE_APPLICATION_PRIVATE_KEY_PATH = os.environ.get(
+    "VONAGE_APPLICATION_PRIVATE_KEY_PATH"
+)
+TO_NUMBER = os.environ.get("TO_NUMBER")
+FROM_NUMBER = os.environ.get("FROM_NUMBER")
+VIDEO_URL = os.environ.get("VIDEO_URL")
+
+from vonage import Auth, Vonage
+from vonage_messages.models import MmsVideo, MmsResource
+
+client = Vonage(
+    Auth(
+        application_id=VONAGE_APPLICATION_ID,
+        private_key=VONAGE_APPLICATION_PRIVATE_KEY_PATH,
+    )
+)
+
+message = MmsVideo(
+    to=TO_NUMBER,
+    from_=FROM_NUMBER,
+    video=MmsResource(url=VIDEO_URL),
+)
+
+response = client.messages.send(message)
+print(response)

messages/mms/send_audio.py

@@ -9,23 +9,19 @@
 VONAGE_APPLICATION_PRIVATE_KEY_PATH = os.environ.get(
     "VONAGE_APPLICATION_PRIVATE_KEY_PATH"
 )
-
 TO_NUMBER = os.environ.get("TO_NUMBER")
 RCS_SENDER_ID = os.environ.get("RCS_SENDER_ID")
+GEOSPECIFIC_API_HOST = os.environ.get("GEOSPECIFIC_API_HOST")
 
-import vonage
+from vonage import Auth, HttpClientOptions, Vonage
 
-client = vonage.Client(
-    application_id=VONAGE_APPLICATION_ID,
-    private_key=VONAGE_APPLICATION_PRIVATE_KEY_PATH,
+client = Vonage(
+    auth=Auth(
+        application_id=VONAGE_APPLICATION_ID,
+        private_key=VONAGE_APPLICATION_PRIVATE_KEY_PATH,
+    ),
+    http_client_options=HttpClientOptions(api_host=GEOSPECIFIC_API_HOST),
 )
 
-client.messages.send_message(
-    {
-        "channel": "rcs",
-        "message_type": "image",
-        "to": TO_NUMBER,
-        "from": RCS_SENDER_ID,
-        "image": {"url": "https://example.com/image.jpg"},
-    }
-)
+response = client.messages.revoke_rcs_message('MESSAGE_UUID')
+print(response)