eSMS for Developers
Đăng nhập
EN - eSMS for Developers
EN - eSMS for Developers
  • Overview
    • Getting started
    • Mechanism
    • Access to the API information
  • eSMS API
    • Send SMS API
      • Send OTP/Customer care message
      • Send adveritising message
      • Send message via Zalo
      • Send message via Viber
      • Send fixed number with cheap price
      • Send multi-channel message via Zalo and SMS
      • Send personized message via Zalo
      • Send Zalo message Consulting in text form
      • Send Zalo message with attached photo
      • Send Zalo message Consulting button
      • Send Zalo Trading message
      • Send Zalo messages to request user's information
      • Send Journey ZNS message
      • Send auto-generated SMS
      • The multichannel auto-generated OTP
    • Retrive and register functions
      • Get balance
      • Get the message status
      • Get SMS by SMSID
      • Get message details
      • Get list registered brandnames
      • Get list customer care templates
      • Summary your customer care submit
      • Summary your advertising submit
      • Get list OA
      • Get list templates of OA
      • Summary Zalo message
      • Get the daily quota of OA
      • Get rating information of Zalo users
      • Check the OA quality
      • Get list Zalo's followers
      • Get callback data
      • Get Zalo template details
      • Purchase OA package
      • Registering the Zalo template
      • Registering SMS template
    • Other APIs
      • Send customer care message using GET
      • Send customer care message using POST X-Form
      • Send customer care message using POST TEXT
      • Send fixed number using GET
      • Send advertising message using POST TEXT
      • Send Zalo message (old version)
      • Send Zalo message using POST X-FORM
      • Send Zalo message full template
      • Send Viber message using GET
      • Check code
    • Svoucher Connect
      • Connect to shortcode service
    • Voice
      • Create voice OTP call
      • Create an auto-call using template
      • Create a call from recording file
      • Get voice call status
    • Table of error codes
    • Test environment ( Sandbox)
    • Callback Url
Powered by GitBook
On this page
  1. eSMS API
  2. Retrive and register functions

Registering SMS template

PreviousRegistering the Zalo templateNextOther APIs

Last updated 4 months ago

This endpoint is used for registering the SMS template.

HTTP request

POST

  • Content Type: application/json

  • Response Type: application/json

curl --location 'https://rest.esms.vn/MainService.svc/json/SubServicePreviewJson/' \
--header 'Content-Type: application/json' \
--data '{
    "ApiKey": "{{ApiKey}}",
    "AssetsUrl": "{{AssetsUrl}}",
    "Brandname": "{{Brandname}}",
    "CallbackUrl": "{{CallbackUrl}}",
    "Content": "{{Content}}",
    "IsUnicode": "{{IsUnicode}}",
    "CustomerEmail": "{{CustomerEmail}}",
    "CustomerName": "{{CustomerName}}",
    "CustomerPhone": "{{CustomerPhone}}",
    "SecretKey": "{{SecretKey}}",
    "ServiceType": 2,
    "SmsType": {{SmsType}}
}'
  • Request body:

Paramter
Type
Required
Description

ApiKey

string

Your API key.

SecretKey

string

Your Secret key.

Content

string

The content of template.

AssetsUrl

string

The URL download of the document that used for registration.

Brandname

string

The brandname that the template is registered for. Note: Brandname must be registered before calling this request.

IsUnicode

string

Template charset 1. Unicode 0. Non-unicode

CustomerEmail

string

The email of customer end that request the registration.

CustomerName

string

The name of customer end that request the registration.

CustomerPhone

string

The phonemail of customer end that request the registration.

ServiceType

string

ServiceType = 2: Register the customer care template or fixed number.

SmsType

string

2: Customer care template. 8: Fixed number template.

CallbackUrl

string

The webhook URL that will be received the result of the registration process. 0: Failed 1: eSMS is received the submit 2: The template is registered successfully


  • Response:

{
    "CodeResult": "100",
    "ErrorMessage": "ViHAT is moderating your template",
    "ServicePreviewId": 52353
}

Valid request.

  • Response body:

Paramter
Type
Description

CodeResult

string

Response code.

ErrorMessage

string

The message error in case of invalid request.

ServicepreviewId

string

ID of template

The detail of error code can refer at .

Get the sample of code for programing languagues to use in Postman refer at .

https://rest.esms.vn/MainService.svc/json/SubServicePreviewJson/
Table of error codes
Link of code samples