Crear ticket desde aplicación externa | Growlat Conversations

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:

Si al crear un ticket ya existe un ticket abierto para el mismo contacto, no se generará un nuevo ticket. En su lugar, se agregará únicamente una observación en el chat.
El ticket se crea inicialmente con estado Expirado, ya que todavía no existe una sesión activa con el contacto. El template será enviado, pero será necesario esperar a que el contacto responda para que se abra la sesión de Meta. Por este motivo, se recomienda incluir un CTA claro en los templates utilizados, incentivando al contacto a responder el mensaje.

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": "Pepe",
    "email": "[email protected]",
    "firstname": "Pepe",
    "lastname": "Ramirez"
  },
  "ticket": {
    "project_id": 1,
    "inbox_id": 1,
    "observations": "Nombre: Pepe \n Empresa: Pepes Company:"
  },
  "template": {
    "id": 1,
    "payload": {
      "language": "es"
    }
  }
}

JSON response (ejemplo)

{}