Operaciones de Mensajes

Enviar Nuevo Mensaje de WhatsApp

post

Este endpoint permite enviar diferentes tipos de mensajes de WhatsApp, incluyendo texto, ubicación, sticker, imagen, video, audio y documento.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

or

or

or

or

or

or

Responses

200

Indica que el mensaje se envió exitosamente.

application/json

or

401

Indica que la solicitud no fue autorizada debido a credenciales inválidas o faltantes.

application/json

post

/messages/send

HTTPcURLJavaScriptPython

POST /api/v1/messages/send HTTP/1.1
Host: core.sellia.com.mx
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 205

{
  "type": "text",
  "clientId": "66c7ecaa94c47e656bd0d06d",
  "text": "Hello",
  "buttons": [
    "Button 1"
  ],
  "globalButton": {
    "id": "global",
    "text": "Button 1",
    "description": "Description on lists",
    "section": "Section on list"
  }
}

{
  "id": "662978a2bb2d012438ecdff5",
  "type": "text",
  "typeUser": "User",
  "user": {
    "id": "6628933bdb2eeba7bd7b7e95",
    "name": "SellIA",
    "username": "sellia"
  },
  "errorCode": null,
  "errorReason": null,
  "deliveredAt": "2024-04-24T21:24:50.520Z",
  "readAt": "2024-04-24T21:24:50.520Z",
  "createdAt": "2024-04-24T21:24:50.520Z",
  "updatedAt": "2024-04-24T21:24:50.520Z",
  "buttons": [
    {
      "id": "global",
      "text": "Button 1",
      "description": "Description on lists",
      "section": "Section on list"
    }
  ],
  "text": "Hello"
}

Recuperar Historial de Mensajes

get

Recupera el historial de mensajes de un cliente específico.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

CLIENT_IDstringRequired

ID interno del cliente/contacto en Sellia.

Query parameters

LAST_MESSAGE_IDstringOptional

Opcional. El ID del último mensaje recuperado en la solicitud anterior, usado para paginación

Example: 66c7ecaa94c47e656bd0d06d

Responses

200

Una lista de mensajes asociados con el cliente especificado.

application/json

lengthintegerOptional

Número total de mensajes en la respuesta

Example: 1

get

/messages/{CLIENT_ID}

HTTPcURLJavaScriptPython

GET /api/v1/messages/{CLIENT_ID} HTTP/1.1
Host: core.sellia.com.mx
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Una lista de mensajes asociados con el cliente especificado.

{
  "length": 1,
  "data": [
    {
      "id": "662978a2bb2d012438ecdff5",
      "type": "text",
      "typeUser": "User",
      "user": {
        "id": "6628933bdb2eeba7bd7b7e95",
        "name": "SellIA",
        "username": "sellia"
      },
      "errorCode": null,
      "errorReason": null,
      "deliveredAt": "2024-04-24T21:24:50.520Z",
      "readAt": "2024-04-24T21:24:50.520Z",
      "createdAt": "2024-04-24T21:24:50.520Z",
      "updatedAt": "2024-04-24T21:24:50.520Z",
      "buttons": [
        {
          "id": "global",
          "text": "Button 1",
          "description": "Description on lists",
          "section": "Section on list"
        }
      ],
      "text": "Hello"
    }
  ]
}

Cerrar Sesión de Chat Actual

post

Cierra la sesión de chat activa para un cliente especificado. El endpoint es idempotente: si el chat ya está cerrado, devuelve true sin error. Si el clientId no tiene formato de ObjectId válido (24 caracteres hex), devuelve 500.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

clientIdstringRequired

El identificador único del cliente cuya sesión de chat se va a cerrar.

Example: 66c7ecaa94c47e656bd0d06d

Responses

200

Indica que la sesión de chat se cerró exitosamente.

application/json

statusbooleanOptional

Indica si el chat se cerró exitosamente

post

/messages/chat/close

HTTPcURLJavaScriptPython

POST /api/v1/messages/chat/close HTTP/1.1
Host: core.sellia.com.mx
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "clientId": "66c7ecaa94c47e656bd0d06d"
}

200

Indica que la sesión de chat se cerró exitosamente.

{
  "status": true
}