⬆️Request and Response

Request to the API endpoint

Send a text message to the order’s buyer

POST https://api.alephcrm.com/v2/orders/{orderId}/messages

Query Parameters

Name	Type	Description
API_KEY*	String	(default=none)
accountId *	Integer	(default=none)
orderId	Integer
message	String
messageOptions	Integer
file	File
fileBase64	String
documentName	String
documentExtension	String

200: OK string

400: Bad Request {"Status": integer, "Message": string}

401: Unauthorized {"Status": integer, "Message": string}

403: Forbidden {"Status": integer, "Message": string}

404: Not Found {"Status": integer, "Message": string}

409: Conflict {"Status": integer, "Message": string}

412: Precondition Failed {"Status": integer, "Message": string}

429: Too Many Requests {"Status": integer, "Message": string}

500: Internal Server Error string

Parameters details

API_KEY

The API_KEY that was provided.

accountId

The Alephee account ID of the shipping label you are trying to get.

orderId

Alephee ID to identify the order. The Alephee order number. It is not the marketplace order number.

message

Text message to be sent to the customer. Max size = 350 characters. This is available only on certain message options. See below.

messageOptions

Message reason for the message to be sent. Available values are:

1 = REQUEST_VARIANTS (Request product variation information) When this option is selected, an automatic text message template is sent to the customer. Can not use a custom free text message (the “message” parameter). This reason is valid only for orders with allowed shipping modes: “cross docking” and “drop off” (refer to the LogisticType property on the GET orders endpoint). The following table illustrate several countries and text messages templates combinations:

Argentina Chile Colombia México Uruguay	Spanish	Hola, por favor confirma las características que quieres del producto que compraste, así podemos concretar el envío.
Brazil	Portuguese	Olá! Por favor, confirme as características que quer para o produto que você comprou, assim, podemos fazer o envio.
Other countries	Not available

2 = REQUEST_BILLING_INFO (Request billing information) When this option is selected, an automatic text message template is sent to the customer asking for billing information. Can not use a custom free text message (the “message” parameter). The following table illustrate several countries and text messages combinations:

Country	Language	Message template
Argentina	Spanish	Para adjuntarte la factura de tu compra necesito los siguientes datos: · Nombre y apellido · DNI · Domicilio · Código postal
Colombia	Spanish	Para adjuntarte la factura de tu compra necesito los siguientes datos: · Nombre y apellido · Tipo y número de documento · Email · Domicilio · Código postal · Código de municipio · Código de departamento
México	Spanish	Para adjuntarte la factura de tu compra necesito los siguientes datos: · Nombre y apellido · RFC · Domicilio · Código postal
Uruguay	Spanish	Para adjuntarte la factura de tu compra necesito los siguientes datos: · Nombre y apellido · Cédula
Other countries	Not available

3 = SEND_INVOICE_LINK (Send invoice link) When this option is selected, it is possible to send with message including the link of the generated invoice. Can use a custom free text message (the “message” parameter). Valid only in México.

4 = OTHER (Others, free field) When this option is selected, I can send any message to the customer, it's a free field. Can use a custom free text message (the “message” parameter).

5 = DELIVERY_PROMISE (Inform delivery promise) When this option is selected, you can inform the delivery promise. Can use a custom free text message (the “message” parameter). This reason is valid only for orders with allowed shipping modes: “Flex” (refer to the LogisticType property on the GET orders endpoint). A brief summary of available messaging reasons by country:

Also, it is possible to send messages with an attached document. There are two ways to attach a document:

1. With form-data parameters:

file

Document file to attach into an order.

2. With a JSON body including a base64-encoded file:

fileBase64

The document to attach into an order. Must be an encoded base64 string of the document´s full content.

documentName

Document name, only for base64 encoded files

documentExtension

Document extension, only for base64 encoded files