SMTP

Overview
It is possible to send MMS messages via SMTP using the MM4 services instead of the HTTP API.
Authentication
MM4 servers support PLAIN and LOGIN AUTH mechanism.
Use the provided SMPP system_id as the username, and the API Key as the password.
System IDs are normally 15 characters in length
Available MM4 Endpoints
TCP
mmsc.tsgglobal.world:2525
TLS/SSL
mmsc.tsgglobal.world:2465
It is recommended to utilize the TLS port when capable. TLS supports versions 1.1 and 1.2.
MM4 Commands
AUTH - Mandatory
DATA - Mandatory
EHLO - Mandatory
HELO - Available
MAIL - Mandatory
NOOP - Available, use to test if the connection is working
QUIT - Available, optional, closing the connection also works
RCPT - Mandatory
RSET - Available
STARTTLS - Disabled, use the TLS port instead
VRFY - Unimplemented, and would be disabled
MM4 Exchange Example
All lines must end with a CRLF. Some data has been omitted for brevity.
Note, arrows > < have been included in the example to denote origin of message.
> Is a response from the server
< Is input from the client
#
< NOOP
> 250 OK
< EHLO your_hostname
> MM4 server babble
< AUTH LOGIN
> 334 VXNlcm5hbWU6
< base64-encoded-system-id
> 334 UGFzc3dvcmQ6
< base64-encoded-api-key
> 235 Authentication successful
< MAIL FROM:<E164-number@hostname>
> 250 Sender OK
< RCPT TO:<E164-number@hostname>
> 250 Recipient OK
< DATA
> 354 enter mail, end with line containing only '.'
< your-mms-content-here
< .
> 250 queued as <message-id>
< QUIT
> 221 BYE
Note the order of the commands:
AUTH must be used before MAIL and RCPT.
RCPT can only be used after a MAIL command.
DATA can only be used after a MAIL and RCPT commands.
QUIT, NOOP can be used at anytime (except while entering mail.)
Failure to do so will result in various errors
#
# AUTH before HELO
503 ERROR: send EHLO first
​
# RCPT or MAIL before EHLO
503 ERROR: send EHLO or HELO first
​
# RCPT before MAIL
503 ERROR: send MAIL first
​
# DATA before MAIL
503 ERROR: need MAIL command
​
# DATA before RCPT
503 ERROR: need RCPT command
Last modified 5mo ago