MMS-Inhalt senden

In diesem Codeausschnitt sehen Sie, wie Sie MMS-Inhalte mithilfe der Messages API versenden können.

WICHTIG! Derzeit werden nur US Short Codes, 10DLC Nummern und SMS Enabled Toll Free Numbers für den Versand von MMS unterstützt. Bei US Short Codes können MMS-Nachrichten an die Netze von AT&T, T-Mobile (früher Sprint) und Verizon in den USA gesendet werden. Erfahren Sie mehr über die Einrichtung von 10DLC Numbers (Hinweis: Diese Seite bezieht sich auf die SMS API, aber der Inhalt des Abschnitts 10 DLC-Richtlinien gilt auch für die Messages API).

Der Nachrichtendurchsatz, die Zustellbarkeit und das SMS-Nachrichtenvolumen können je nach Art der verwendeten Numbers variieren. Weitere Informationen hierzu und zu MMS im Allgemeinen finden Sie in der Vonage MMS Übersichtsseitedie Vonage 10DLC Übersichtsseiteund die Vonage Phone Numbers Übersichtsseite.

Beispiel

Nachstehend finden Sie die Beschreibung aller in den einzelnen Codeausschnitten verwendeten Variablen:

Schlüssel	Beschreibung
`MESSAGES_API_URL`	There are two versions of the API, each with their own endpoints. For production the previous Messages API endpoint was `https://api.nexmo.com/v0.1/messages`, the new one is `https://api.nexmo.com/v1/messages`. For sandbox testing the Messages API endpoint is `https://messages-sandbox.nexmo.com/v0.1/messages` or `https://messages-sandbox.nexmo.com/v1/messages`, depending on which version you have set in the sandbox dashboard.
`MESSAGES_TO_NUMBER`	The number you are sending the to in E.164 format. For example `447700900000`.
`MMS_SENDER_ID`	The alphanumeric string that represents the name or number of the organization sending the message.
`MESSAGES_IMAGE_URL`	The publicly accessible URL of the image attachment. Supported types are .jpg, .jpeg, and .png
`MESSAGES_FILE_URL`	The publicly accessible URL of the file attachment.

HINWEIS: Verwenden Sie kein führendes + oder 00 Wenn Sie eine Telefonnummer eingeben, beginnen Sie mit der Landesvorwahl, z. B. 14155550105.

Voraussetzungen

Wenn Sie keine Bewerbung haben, können Sie einen erstellen aufrufen. Stellen Sie sicher, dass Sie auch Ihre Webhooks konfigurieren.

Schreiben Sie den Code

Fügen Sie Folgendes zu send-mms-content.sh hinzu:

curl -X POST "${MESSAGES_API_URL}" \
  -H "Authorization: Bearer "$JWT\
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d $'{
    "to": "'${MESSAGES_TO_NUMBER}'",
    "from": "'${MMS_SENDER_ID}'",
    "channel": "mms",
    "message_type": "content",
    "content": [
      {
        "type": "image",
        "url": "'${MESSAGES_IMAGE_URL}'"
      },
      {
        "type": "file",
        "url": "'${MESSAGES_FILE_URL}'"
      }
    ]
  }'

Vollständige Quelle anzeigen

Führen Sie Ihren Code aus

Speichern Sie diese Datei auf Ihrem Rechner und führen Sie sie aus:

bash send-mms-content.sh

Voraussetzungen

Wenn Sie keine Bewerbung haben, können Sie einen erstellen aufrufen. Stellen Sie sicher, dass Sie auch Ihre Webhooks konfigurieren.

Fügen Sie Folgendes zu build.gradle hinzu:

implementation 'com.vonage:server-sdk-kotlin:2.1.1'

Erstellen Sie eine Datei mit dem Namen SendMmsContent und fügen Sie den folgenden Code in die Methode main ein:

val client = Vonage {
    applicationId(VONAGE_APPLICATION_ID)
    privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
}

Vollständige Quelle anzeigen

Schreiben Sie den Code

Fügen Sie der Methode main in der Datei SendMmsContent Folgendes hinzu:

val messageId = client.messages.send(
    mmsContent {
        to(MESSAGES_TO_NUMBER)
        from(MMS_SENDER_ID)
        addImage(MESSAGES_IMAGE_URL)
        addFile(MESSAGES_FILE_URL)
    }
)

Vollständige Quelle anzeigen

Führen Sie Ihren Code aus

Wir können das Anmeldung Plugin für Gradle verwenden, um die Ausführung unserer Anwendung zu vereinfachen. Aktualisieren Sie Ihre build.gradle mit dem Folgenden:

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Führen Sie den folgenden Befehl gradle aus, um Ihre Anwendung auszuführen, und ersetzen Sie dabei com.vonage.quickstart.kt.messages.mms durch das Paket, das SendMmsContent enthält:

gradle run -Pmain=com.vonage.quickstart.kt.messages.mms.SendMmsContent

Voraussetzungen

Wenn Sie keine Bewerbung haben, können Sie einen erstellen aufrufen. Stellen Sie sicher, dass Sie auch Ihre Webhooks konfigurieren.

Fügen Sie Folgendes zu build.gradle hinzu:

implementation 'com.vonage:server-sdk:9.3.1'

Erstellen Sie eine Datei mit dem Namen SendMmsContent und fügen Sie den folgenden Code in die Methode main ein:

VonageClient client = VonageClient.builder()
		.applicationId(VONAGE_APPLICATION_ID)
		.privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
		.build();

Vollständige Quelle anzeigen

Schreiben Sie den Code

Fügen Sie der Methode main in der Datei SendMmsContent Folgendes hinzu:

var response = client.getMessagesClient().sendMessage(
		MmsContentRequest.builder()
			.from(MMS_SENDER_ID).to(MESSAGES_TO_NUMBER)
			.addImage(MESSAGES_IMAGE_URL)
			.addFile(MESSAGES_FILE_URL)
			.build()
);
System.out.println("Message sent successfully. ID: "+response.getMessageUuid());

Vollständige Quelle anzeigen

Führen Sie Ihren Code aus

Wir können das Anmeldung Plugin für Gradle verwenden, um die Ausführung unserer Anwendung zu vereinfachen. Aktualisieren Sie Ihre build.gradle mit dem Folgenden:

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Führen Sie den folgenden Befehl gradle aus, um Ihre Anwendung auszuführen, und ersetzen Sie dabei com.vonage.quickstart.messages.mms durch das Paket, das SendMmsContent enthält:

gradle run -Pmain=com.vonage.quickstart.messages.mms.SendMmsContent

Probieren Sie es aus

Wenn Sie den Code ausführen, wird eine MMS-Nachricht mit einem Bild und einer Datei an die Zielnummer gesendet.