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
  • Obtener contacto por campo personalizado
  • Obtener contacto por ID
  • Actualizar contacto por ID
  • Agregar etiqueta por ID
  • Eliminar etiqueta por ID
  • Crear contacto
  • 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)
  • Limitaciones

¿Te fue útil?

  1. API DE DESARROLLADORES

API de contactos

Le permite agregar, editar y recuperar información de contacto a través de API.

AnteriorZapierSiguienteAPIV2

Última actualización hace 4 años

¿Te fue útil?

Las llamadas a la API se realizan por canal. Los tokens se pueden generar usando el icono de llave, junto al canal deseado en Configuración . Hay un límite de frecuencia de 100 llamadas API por minuto.

Peticiones

La API de contactos se compone de varias solicitudes:

Obtener contacto por campo personalizado

Esta solicitud devuelve una lista de objetos de contacto con paginación.

/v1/contact/by_custom_field

Ejemplo de solicitud GET

curl -X GET \
      'https://app.1980tic.us/api/v1/contact/by_custom_field?name=firstName&value=Muhammad%20Mahin' \
      -H 'Authorization: Bearer {channel_token}' \
      -H 'Content-Type: application/json'

Respuesta: éxito (estado HTTP → 200)

{
      "data": [
        {
          "id": "1776025372480910",
          "custom_fields": {
            "firstName": "Mahin",
            "lastName": "Dar",
            "locale": "en_GB",
            "timezone": "5",
            "gender": "male",
            "phone": "123123",
            "email": "muhammad@respond.io",
            "customerid": "1"
          },
          "tags": [
            "Blog Updates",
            "Platform Updates"
          ],
          "created_at": 1575618542
        }
      ],
      "links": {
        "first": "http://app.1980TIC.com/api/v1/contact/by_custom_field?page=1",
        "last": "http://app.1980TIC.com/api/v1/contact/by_custom_field?page=1",
        "prev": null,
        "next": null
      },
      "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "http://app.1980TIC.com/api/v1/contact/by_custom_field",
        "per_page": 10,
        "to": 1,
        "total": 1
      }
    }

Obtener contacto por ID

Esta solicitud devuelve un único objeto de contacto.

/v1/contact/{contact_id}

Ejemplo de solicitud GET

curl -X GET \    
       https://app.1980tic.us/api/v1/contact/1776025372480910 \
         -H 'Autorización: Portador {channel_token}' \   
         -H 'Tipo de contenido: aplicación / json' \

Respuesta: éxito (estado HTTP → 200)

{
        "data": {
            "id": "1776025372480910",
            "custom_fields": {
                "firstName": "Mahin",
                "lastName": "Dar",
                "locale": "en_GB",
                "timezone": "5",
                "gender": "male",
                "phone": "123123",
                "email": "muhammad@respond.io",
                "customerid": "1"
            },
            "tags": [
                "Blog Updates",
                "Platform Updates"
            ],
            "created_at": 1575618542
        }
    }

Actualizar contacto por ID

Esta solicitud actualiza un valor de campo personalizado de contacto.

/v1/contact/{contact_id}

Ejemplo de solicitud PUT

curl -X PUT \
      https://app.1980tic.us/api/v1/contact/1776025372480910 \
      -H 'Authorization: Bearer {channel_token}' \
      -H 'Content-Type: application/json' \
      -d '{
        "custom_fields": [
            {
                "name": "firstName",
                "value": "Muhammad Mahin"
            },
            {
                "name": "lastName",
                "value": "Dar"
            }
        ]
    }'

Respuesta: éxito (estado HTTP → 200)

{
      "data": {
        "id": "cus_112233344555"
      }
    }

Limitaciones

Máximo 30 campos actualizados por solicitud.

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 .

Agregar etiqueta por ID

Esta solicitud agrega etiquetas para un contacto.

/v1/contact/{contact_id}/tags

Ejemplo de solicitud POST

curl -X POST \
      https://app.1980tic.us/api/v1/contact/1776025372480910/tags \
      -H 'Authorization: Bearer {channel_token}' \
      -H 'Content-Type: application/json' \
      -d '{
        "tags": [
            "Blog Updates",
            "Platform Updates"
        ]
    }'

Respuesta: éxito (estado HTTP → 200)

{
        "status": "success",
        "message": "Contact Tags have been added successfully.",
        "data": []
    }

Limitaciones

Máximo 10 etiquetas agregadas por solicitud.

Eliminar etiqueta por ID

Esta solicitud elimina las etiquetas de un contacto.

/v1/contact/{contact_id}/tags

Ejemplo de solicitud DELETE

curl -X DELETE \
      https://app.1980tic.us/api/v1/contact/1776025372480910/tags \
      -H 'Authorization: Bearer {channel_token}' \
      -H 'Content-Type: application/json' \
      -d '{
        "tags": [
            "Blog Updates",
            "Platform Updates"
        ]
    }'

Respuesta: éxito (estado HTTP → 200)

{
        "status": "success",
        "message": "Contact Tags deleted successfully.",
        "data": []
    }

Limitaciones

Máximo de 10 etiquetas eliminadas por solicitud.

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.

Crear contacto

Esta solicitud crea un contacto y establece valores para sus campos personalizados.

/v1/contact

Ejemplo de solicitud GET

curl -X POST \
      https://app.1980tic.us/api/v1/contact/ \
      -H 'Authorization: Bearer {channel_api_token}' \
      -H 'Content-Type: application/json' \
      -d '{
        "custom_fields": [
            {
                "name": "phone",
                "value": "03244077087"
            },
            {
                "name": "firstName",
                "value": "Muhammad Mahin"
            },
            {
                "name": "lastName",
                "value": "Dar"
            }
        ]
    }'

Respuesta: éxito (estado HTTP → 200)

{
        "data": {
            "id": "cus_112233344555"
        }
    }

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": []
  }

Limitaciones

Máximo 30 campos creados por solicitud.

📥
Obtener contacto por campo personalizado
Obtener contacto por ID
Actualizar contacto por ID
Añadir etiqueta por ID
Elimina la etiqueta de ID
Crear contacto