Crear ticket desde aplicación externa | Convos

La creación de un ticket desde una aplicación externa te permitirá crear una conversación en Convos de manera automática con un contacto a partir de un evento o en el momento que lo necesites.

Requisitos:

Tu X-Tenant.
https://help.convos.la/es/articles/8452332-x-tenant

Un token con la habilidad de "Tickets".
https://help.convos.la/es/articles/8306556-token-de-acceso

Un ID de proyecto (projectId)
Un ID de bandeja de entrada (inboxId)
Un ID de template pre-asignado a la bandeja de entrada (templateId)

Importante:

En caso de crear un ticket y ya se encuentra un ticket abierto para el contacto, solo se creará la observación en el chat.

Configuración de la request:

Descripción	Crear ticket desde aplicación externa.
HTTP Method	POST
Headers	X-Tenant: {YourXTenant} Authorization: Bearer {YourToken}
URL	https://api.convos.la/consumer/tickets
JSON request (ejemplo)	Ver más abajo los ejemplos.
Paginación y filtrado (ejemplo)	*none*

Ejemplo:

Descripción

Crear ticket desde aplicación externa.

JSON request (ejemplo)

{
  "contact": {
    "cellphone": "cellphone"
  },
  "ticket": {
    "project_id": "<projectId>",
    "inbox_id": "<inboxId>",
    "observations": "<observations>"
  },
  "template": {
    "id": "<templateId>",
    "payload": "<payload>"
  }
}

JSON response (ejemplo)

{}

Un ID de proyecto (projectId)

Para obtener el ID de proyecto hay que ir a la sección de canales dentro de configuraciones del menú de usuario. Una vez en canales, hace clic en administrar sobre el canal de WhatsApp.

https://www.app.convos.la/project/settings/channels

Un ID de bandeja de entrada (inboxId)

Para obtener el ID de bandeja de entrada hay que ir a la sección de conversaciones, luego bandeja de entrada.

https://www.app.convos.la/conversations

Un ID de template pre-asignado a la bandeja de entrada (templateId)

Dentro la edición de una bandeja de entrada se debe tener pre-asignado el template en la bandeja de entrada.

Ejemplo con información de las capturas:

Descripción

Crear ticket desde aplicación externa.

JSON request (ejemplo)

{
  "contact": {
    "cellphone": "+5491162584120",
    "name": "Nicolas",
    "email": "[email protected]",
    "firstname": "Nicolas",
    "lastname": "Marquart"
  },
  "ticket": {
    "project_id": 1,
    "inbox_id": 1,
    "observations": "Nombre: Nicolas \n Empresa: Growlat:"
  },
  "template": {
    "id": 1,
    "payload": {
      "language": "es"
    }
  }
}

JSON response (ejemplo)

{}