WhatsApp API createApp - nxtele/nxcloud-doc-en GitHub Wiki

Create Customer Application for Integrators

Initiate the service to create a customer application through the API (for integrators only).

  • URL: https://api2.nxcloud.com/api/wa/integrator/embedded/register/createApp
  • Method: POST
  • Content-Type: application/json
  • Requires authentication: Yes

Authentication Mechanism

Please refer to the following link for authentication rules: API Interface Call Convention

Request Parameters

Header Parameters:

Parameter Name Type Required Example Description
accessKey String Yes fmexxx3ki User identity identifier
ts String Yes 1655710885431 Current timestamp of the request (in milliseconds). The maximum allowed time difference is 60 seconds on the server side.
bizType String Yes 2 WhatsApp business type, fixed value "2"
action String Yes createApp WhatsApp business operation, fixed value "createApp"
sign String Yes 6e95xxx826 API input parameter signature, signature algorithm

Body Parameters:

Parameter Name Type Required Example Description
app_name String Yes Whatsapp Application name
webhook String Yes https://***/api/webhook/whatsApp Webhook address

Request Example

Body (application/json) parameters:

{
    "app_name": "Whatsapp",
    "webhook": "https://***/api/webhook/whatsApp"
}

Response Parameters

Parameter Name Type Description
code Integer Result code
data JsonObject Request result
message String Request result description

Response Example

Successful Example

{
    "code": 0,
    "data": {
        "app_id": 1000,
        "app_name": "Whatsapp",
        "app_key": "KI92cew9"
    },
    "message": "Request successful"
}

Failed Example

{
    "code": -1,
    "message": "Request failed",
    "data": null
}

Response Code Explanation

code message Solution
0 Request successful
-1 Request failed Please contact technical support to troubleshoot the issue
1000~100X Authentication issue Refer to the API authentication section for details
9000 Parameter exception Missing parameters, please check the required parameters
9001 System business error Please contact technical support to troubleshoot the issue
9007 Non-integrator request Please confirm if you are an integrator
9009 Maximum of 1000 customer applications reached Maximum of 1000 customer applications can be created