1980TIC Cloud
  • La plataforma de Bot de 1980 TIC Cloud
  • 📖Glosario de términos
  • Comenzando
    • ⚡Inicio rápido
    • 🔌Conectando un canal
    • 👥Invita a tus compañeros de equipo
    • ✏️ Responder a los mensajes
    • 🤖Creando un chatbot
  • Módulos de espacio de trabajo
    • 📊Escritorio- Dashboard
    • 💬Mensajes- Messages
      • Asignación y cierre de una conversación
    • 👩‍💼 Contactos- Contacts
      • Detalles de contacto
      • Actividad de contacto
      • Canales de contacto
      • Importar Contactos
    • 📨Transmisiones
    • 📈Flujos de trabajo
      • Disparadores
      • Pasos
    • 📑Informes
      • Conversaciones
      • Usuarios
      • Contactos
      • Mensajes
      • Registros
  • Ajustes del espacio de trabajo
    • 🗃️Administrar un espacio de trabajo
    • General
    • Usuarios
      • Nivel de acceso
    • Equipos
    • Canales
      • Menús del chat
    • Campos de contacto
    • Integraciones
    • Notas de cierre
    • Fragmentos
    • Archivos
    • Exportación de datos
    • Importación de datos
  • Configuración de la importación
    • Administrar una organización
      • General
      • Usuarios de la organización
      • Espacios de trabajo
        • Gestión de múltiples espacios de trabajo
      • Facturación y uso
  • CUENTA DE USUARIO
    • 👤Perfil del usuario
    • ✅Actividad del usuario
    • 📢Notificaciones
    • 🔁Restablecer su contraseña
  • CONTACTOS Y MENSAJES
    • 🎯Variables dinámicas
    • 👁️‍🗨️ Vistas de contacto
    • Conversaciones
  • CANALES DE MENSAJERIA
    • 🗃️ Resumen de canales
    • ✔️ Facebook Messenger
      • Chat online de Facebook
      • Respuestas privadas
      • Mensaje de etiqueta
    • ✔️ Gmail
    • ✔️ WhatsApp
      • API en la nube de WhatsApp
      • 360Dialog WhatsApp
      • Twilio WhatsApp
      • MensajeBird WhatsApp
      • WhatsApp de Vonage
      • Plantillas de mensajes de WhatsApp
    • ✔️ Widget de chat online
      • Instalar en WordPress
      • Instalar en Shopify
      • Instalar en Wix
      • Instalar en Joomla
      • Instalar en Squarespace
    • ✔️ LINE
    • ✔️ Telegram
    • ✔️ Viber
    • ✔️ SMS
      • Twilio SMS
      • MessageBird SMS
      • Vonage SMS
    • ✔️ Twitter
    • ✔️ WeChat
  • INTEGRACIONES
    • 🆗Dialogflow
      • Conectando a Dialogflow
      • Gestión de intenciones
        • Parámetros
          • Etiquetado
          • Apagando el Bot
          • Marcando como hecho
          • Asignar
          • Envío de notificaciones personalizadas
          • Darse de baja
          • Campos de contacto y valores
          • Envío de atajos
          • Envío de archivos
          • Solicitando ubicación
        • Eventos
        • Plantillas de respuesta
        • Cargas útiles personalizadas
        • Request de webhook (Fulfillment)
    • 🆗Chatbase
    • 🆕Zapier
  • API DE DESARROLLADORES
    • 📥API de contactos
    • 📥APIV2
    • 💭API de mensajes
Con tecnología de GitBook
En esta página
  • Peticiones
  • Enviar solicitud de texto
  • Enviar solicitud de adjunto
  • Enviar mensaje de texto con solicitud de respuestas rápidas
  • ​Códigos de error
  • No autorizado (estado HTTP → 401)
  • Demasiadas solicitudes (estado HTTP → 429)
  • Método no permitido (estado HTTP → 405)
  • General (Estado HTTP → 403)
  • Tipo de archivo incomparable (Estado HTTP → 403)
  • Limitaciones

¿Te fue útil?

  1. API DE DESARROLLADORES

API de mensajes

Le permite enviar mensajes que contienen texto, imagen, audio, vídeo o archivo a contactos en la plataforma.

AnteriorAPIV2

Última actualización hace 4 años

¿Te fue útil?

Se requiere el token de canal para acceder a este recurso de API. Los tokens se pueden generar usando el icono de llave, junto al canal deseado en Configuración.

Peticiones

La API de contactos se compone de varios tipos de solicitudes:

Enviar solicitud de texto

Esta solicitud envía un mensaje de texto directamente al contacto según se define en el punto final.

POST /v1/message/sendContent/{contactId}

Ejemplo de solicitud de texto POST

curl -X POST \
      https://app.1980tic.us/api/v1/message/sendContent/{contactId} \
      -H 'Authorization: Bearer {channel_token}' \
      -H 'Content-Type: application/json' \
      -d '{
  "body": [
  	{
  		"type" : "text",
  		"text" : "Hi there"
  	}
  ]
}'

Respuesta: éxito (estado HTTP → 200)

    {
      "status": "Success",
      "message": "Message Sent",
      "data": []
  }

Tenga en cuenta que en el caso del canal Viber, debido a una cierta limitación, la ID de contacto debe proporcionarse en un formato codificado en Base64.

Enviar solicitud de adjunto

Esta solicitud envía un archivo adjunto en forma de URL directamente al contacto según se define en el punto final. El archivo puede ser imagen, video, audio o archivo.

POST /v1/message/sendContent/{contactId}

Solicitud de envío de imagen POST de muestra

curl -X POST \
      https://app.1980tic.us/api/v1/message/sendContent/{contactId} \
      -H 'Authorization: Bearer {channel_token}' \
      -H 'Content-Type: application/json' \
      -d '{
  "body": [
  	{
  		"type" : "image",
  		"url" : "http://abc.com"
  	}
  	}
  ]
}'

Respuesta: éxito (estado HTTP → 200)

    {
      "status": "Success",
      "message": "Message Sent",
      "data": []
  }

Solicitud de envío de video POST de muestra

curl -X POST \
      https://app.1980tic.us/api/v1/message/sendContent/{contactId} \
      -H 'Authorization: Bearer {channel_token}' \
      -H 'Content-Type: application/json' \
      -d '{
  "body": [
  	{
  		"type" : "video",
  		"url" : "http://abc.com"
  	}
  	}
  ]
}'

Respuesta: éxito (estado HTTP → 200)

    {
      "status": "Success",
      "message": "Message Sent",
      "data": []
  }

Ejemplo de solicitud de envío de audio POST

curl -X POST \
      https://app.1980tic.us/api/v1/message/sendContent/{contactId} \
      -H 'Authorization: Bearer {channel_token}' \
      -H 'Content-Type: application/json' \
      -d '{
  "body": [
  	{
  		"type" : "audio",
  		"url" : "http://abc.com"
  	}
  	}
  ]
}'

Respuesta: éxito (estado HTTP → 200)

    {
      "status": "Success",
      "message": "Message Sent",
      "data": []
  }

Ejemplo de solicitud de envío de archivos POST

curl -X POST \
      https://app.1980tic.us/api/v1/message/sendContent/{contactId} \
      -H 'Authorization: Bearer {channel_token}' \
      -H 'Content-Type: application/json' \
      -d '{
  "body": [
  	{
  		"type" : "audio",
  		"url" : "http://abc.com"
  	}
  	}
  ]
}'

Respuesta: éxito (estado HTTP → 200)

    {
      "status": "Success",
      "message": "Message Sent",
      "data": []
  }

Enviar mensaje de texto con solicitud de respuestas rápidas

Esta solicitud envía un mensaje de texto con respuestas rápidas para los receptores.

curl -X POST \
      https://app.1980tic.us/api/v1/message/sendContent/{contactId} \
      -H 'Authorization: Bearer {channel_token}' \
      -H 'Content-Type: application/json' \
      -d '{
  "body": [
  	
    {
      "type":"quick_reply",
    	"title" : "What is you favorite color?",
    	"replies" : ["Black","Blue","Grey","Red"]
    }
    
  ]
}'

Respuesta: éxito (estado HTTP → 200)

    {
      "status": "Success",
      "message": "Message Sent",
      "data": []
  }

​Códigos de error

No autorizado (estado HTTP → 401)

{
        "status": "error",
        "message": "API Token is invalid.",
        "data": []
    }

Demasiadas solicitudes (estado HTTP → 429)

   {
      "status": "error",
      "message": "Too many requests",
      "data": []
  }

Método no permitido (estado HTTP → 405)

   {
      "status": "error",
      "message": "405 Method Not Allowed.",
      "data": []
  }

General (Estado HTTP → 403)

  {
      "status": "error",
      "message": "Message String",
      "data": []
  }

Tipo de archivo incomparable (Estado HTTP → 403)

  {
      "status": "error",
      "message": "Sorry, Url provided is not an image/audio/video file",
      "data": []
  }

Limitaciones

  • Solo se puede enviar un mensaje en una llamada a la API.

  • API tiene un límite de velocidad de 25 RPS.

  • Se permiten 10 respuestas rápidas de 20 caracteres cada una.

  • La encuesta no se cancela de forma predeterminada. debe enviarse explícitamente en la carga útil.forceCancelSurvey : trueEl estado del contacto no se cambiará en la llamada a la API.

💭
Enviar mensajes de texto
Enviar datos adjuntos
Enviar texto con respuestas rápidas