Vincular un deal a una conversación

Apunta un deal a la conversación de un contacto en el número propio del deal.

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

PUT https://api.getincloud.ai/v1/deals/{dealId}/chat

Apunta un deal a la conversación de un contacto en el número propio del deal.

El cuerpo indica un contacto, no un chat: contactWid es la identidad sobre la que se basa el embudo, y la conversación se resuelve a partir de ella en el servidor, teniendo en cuenta la equivalencia @c.us/@lid. Al vincular, se reasigna tanto la contraparte del deal como su conversación: todas las identidades que ha tenido el deal siguen siendo localizables en las búsquedas, de modo que ni el contacto anterior ni el nuevo puedan terminar con un segundo deal abierto en el pipeline.

Usa la misma petición para mover un deal a otra conversación. No existe la opción de desvincular: si se borrara la conversación, el trabajo de reconciliación lo deshará en su siguiente pasada, ya que vuelve a vincular un deal cuyo contacto tiene una conversación.

Nota: este recurso de la API está disponible en la suscripción Platform Professional y superiores.

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`contactWid`	string	Sí	ID de WhatsApp del contacto cuya conversación se vincula al deal. Obligatorio `minLength: 5` · `maxLength: 50` · `pattern: @(c\.us`

Respuestas

Código	Descripción
`200`	Deal vinculado
`400`	El contacto no tiene ninguna conversación en el número del deal
`401`	No autorizado: token de API inválido o ausente
`403`	Operación no admitida: se requiere actualizar el plan, o el usuario no puede leer la conversación
`404`	Deal no encontrado
`409`	Ya existe otro deal abierto para ese contacto en el pipeline
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Servicio no disponible temporalmente: inténtalo de nuevo más tarde

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Link a deal to the conversation of a contact
curl --request PUT \
  --url https://api.getincloud.ai/v1/deals/{dealId}/chat \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"contactWid":"34600111222@c.us"}'

AnteriorObtener pipelines SiguienteAceptar los términos de IA de Meta

¿Te sirvió esta página?