Compartir a través de


Solicitud de texto

La solicitud de texto es una plataforma de texto empresarial creada para encender la involucración del cliente. Hemos creado una solución de mensajería plug-and-play para sus problemas de comunicación cotidianos, por lo que puede cortar el ruido y conectarse con los clientes en cualquier momento, en cualquier lugar. Obtenga más información sobre cómo ayudamos a los líderes empresariales ocupados como usted.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Compatibilidad con Text Request API
URL https://www.textrequest.com/contact
Correo Electrónico apidev@textrequest.com
Metadatos del conector
Publicador Solicitud de texto
Sitio web https://www.textrequest.com/
Directiva de privacidad https://www.textrequest.com/privacy-policy/
Categorías Comunicación; Ventas y CRM

Aranda Service Management Suite (ASMS)

Aumente la productividad de su empresa y transforme la experiencia de los usuarios con Aranda Service Management Suite, la solución multiinquilino que le permite administrar, integrar y automatizar procesos y servicios empresariales. Crear, buscar y actualizar registros almacenados en cualquier área de trabajo (proyecto) de ASMS, incluidos incidentes, requisitos y cambios, entre otros.

Requisitos previos

Tenga en cuenta los siguientes requisitos previos para continuar:

  • Una suscripción y una instancia de Aranda Service Management Suite (ASMS). Comience aquí: https://arandasoft.com/
  • Una suscripción activa de Microsoft Power Automate con funcionalidades del conector Premium.

Obtención de credenciales

  • Para realizar la autenticación, use el token de integración. En el vínculo siguiente encontrará información sobre cómo obtener el token de integración.

Introducción al conector

  1. Requiere una suscripción a Aranda Service Management Suite (ASMS).

  2. Obtención del token de integración

  3. Obtenga la dirección URL de instancia de la API de ASMS de Aranda Service Management (ApiAsms).

  4. Establezca una conexión con el conector de Aranda Service Management Suite.

  5. Seleccione una de las siguientes funciones que ofrece el conector:

    Boleto

  6. Para obtener documentación detallada sobre el conector, consulte https://docs.arandasoft.com/connectors

Puede usar este conector en los casos siguientes:

  1. Crear, buscar y actualizar vales, entre otras acciones disponibles.
  2. Obtenga la rastreabilidad de vales.
  3. Descargue los datos adjuntos relacionados con un vale.
  4. Busque artículos de knowledge base (KB) en Aranda Service Management Suite.
  5. Descargue datos adjuntos de artículos de knowledge base (KB).
  6. Crear, buscar y actualizar elementos de configuración (ICI).
  7. Permite a las organizaciones resolver sus solicitudes de soporte técnico internas, administrar y simplificar el proceso de resolución de problemas técnicos.
  8. Permite el seguimiento de las comunicaciones entre los solicitantes y los agentes de soporte técnico.
  9. Ofrezca respuestas automatizadas para informar a los solicitantes del estado de su vale.

Respuesta exitosa

Código Nombre Description
200 OK La solicitud fue exitosa
204 Sincontenido No se encontraron datos en la solicitud

Errores y soluciones comunes

Código Nombre Description Solución
400 Solicitud incorrecta CriteriaNeedsSomeArguments Compruebe que los parámetros de búsqueda no están vacíos
400 Solicitud incorrecta InvalidAdditionalFieldId Compruebe que los identificadores de los campos adicionales son correctos.
400 Solicitud incorrecta InvalidItemType El tipo de caso es incorrecto, cambie el identificador de tipo de caso.
400 Solicitud incorrecta InvalidProjectId El identificador del proyecto es incorrecto, cambie el identificador del proyecto al que asociará el caso.
400 Solicitud incorrecta InvalidStateId Compruebe el estado agregado al crear o actualizar un vale
400 Solicitud incorrecta InvalidUploadType Error al adjuntar un archivo, Solicitar asistencia del administrador del sistema
400 Solicitud incorrecta RequestNeedsSomeArguments Compruebe los campos obligatorios del vale y agregue el valor correspondiente de estos en el conector.
400 Solicitud incorrecta SearchListIsRequired Solicitar ayuda de un administrador del sistema
400 Solicitud incorrecta Nombre del parámetro: {Name parameter} Compruebe que las propiedades mencionadas en el error no son null
400 Solicitud incorrecta Es un nombre de parámetro null: {Name parameter} Compruebe que las propiedades mencionadas en el error no son null
400 Solicitud incorrecta ItemTypeIsRequired Agregar tipo de caso
400 Solicitud incorrecta ModelIdIsEmpty Agregue el parámetro modelId. Es necesario.
400 Solicitud incorrecta StateIdIsEmpty Agregue el parámetro stateId. Es necesario.
400 Solicitud incorrecta ServiceIdIsEmpty Agregue el parámetro serviceId. Es necesario.
400 Solicitud incorrecta CategoryIdIsEmpty Agregue el parámetro categoryId. Es necesario.
400 Solicitud incorrecta TypesListNeedsSomeArguments Requiere agregar el tipo de caso al buscar vales, Solicitar asistencia de un administrador del sistema
400 Solicitud incorrecta '{PARAMETER_NAME}' AdditionalFieldIsRequired El campo adicional '{PARAMETER_NAME}' es obligatorio
400 Solicitud incorrecta ModelNotActive El modelo asociado al caso no está activo
400 Solicitud incorrecta FailedToCloseTaskPendingCloseTasksPredecessors Si intenta cerrar el caso y el caso primario tiene tareas pendientes para cerrar
400 Solicitud incorrecta DuplicatedObject La ci ya existe en la base de datos
400 Solicitud incorrecta Nombre del parámetro EmptyValue: {PARAMETER_NAME} Se requiere el parámetro {PARAMETER_NAME}
400 Solicitud incorrecta Nombre del parámetro EmptyEnumeration: {PARAMETER_NAME} El parámetro {PARAMETER_NAME} es una lista y es necesaria
403 Prohibido DoNotHavePermissionForThisAction Hable con el administrador del sistema para asignar permisos.
Código Nombre Description Solución
500 Error Interno del Servidor Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureExportExcel Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetAdditionalFields Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetCategoriesByService Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetChangeFSC Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetFields Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetFieldsList Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetFiles Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetLookupValues Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetMailTemplates Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetModelByCategory Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetOperators Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetReassignmentReasons Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureGetSimilarItems Solicitar ayuda de un administrador del sistema
500 Error Interno del Servidor FailureSearchQuickManagement Solicitar ayuda de un administrador del sistema

Preguntas más frecuentes

  1. ¿Cómo recuperar los identificadores de los atributos necesarios para usar las diferentes acciones del conector (por ejemplo, proyecto, servicio, categoría, grupo, especialista)?

    Los identificadores se pueden recuperar de muchas maneras:

    • Con el Administrador de consultas de Aranda, puede crear un informe que consulte la tabla Aranda Service Management Suite (ASMS) donde se encuentran los datos necesarios. Si necesita instrucciones sobre los objetos de datos de la solución, visite el vínculo https://docs.arandasoft.com/docs/database.html siguiente e identifique la versión de la base de datos de Aranda correspondiente a la instalación de ASMS.
    • Si usa una instalación local de ASMS, puede consultar la tabla ASMS donde se encuentran los datos necesarios a través de un cliente SQL.
    • A través del Centro de soporte técnico de Aranda, creando una solicitud de soporte técnico a través de los canales de contacto indicados en el siguiente sitio web soporte técnico.
  2. ¿Cuál es el tamaño máximo de los archivos que se van a adjuntar al usar la acción "Agregar datos adjuntos"?

    El tamaño máximo depende de la configuración específica de la instancia o instalación de ASMS. Pregunte al administrador de ASMS.

  3. ¿Cuál es el nivel de acceso a datos requerido por la cuenta del técnico cuyo token se usa en la configuración de la conexión de ASMS requerida por el conector?

    El nivel de acceso es el mismo que la cuenta del técnico que se usa en ASMS de forma periódica. En otras palabras, en función de los roles y permisos del técnico correspondiente en ASMS, se puede acceder a los datos con el conector.

  4. ¿Debe la cuenta del técnico cuyo token se usará en el conector se denominará o concurrente?

    Dado que el conector puede acceder a la instancia de ASMS relacionada varias veces por hora, se recomienda encarecidamente que la cuenta sea un tipo con nombre.

  5. ¿La creación o modificación de casos mediante el conector sigue las mismas reglas de validación de datos presentes en la interfaz de ASMS?

    Sí, sigue las mismas reglas de validación. Por ejemplo, al crear un caso para un proyecto, servicio y categoría específicos, si se deben rellenar campos nativos y adicionales, estos datos también son necesarios al enviar el caso a través del conector.

  6. ¿Se puede usar el conector para las instancias de ASMS en entornos locales y en la nube?

    Sí, se puede usar en instalaciones locales y en la nube de ASMS. En Instalaciones locales, debe tener en cuenta la conectividad entre el servidor ASMS y el entorno de Power Automate.

  7. Tengo una licencia de Power Automate que solo me permite usar conectores estándar. ¿Puedo usar el conector de ASMS?

    No es posible, el conector de ASMS es de tipo Premium.

  8. Quiero crear flujos en Power Automate que comiencen desde eventos en ASMS (por ejemplo, cuando se ha creado un caso, cuando se asigna un caso a un grupo específico). ¿Es posible usar desencadenadores que comienzan desde eventos que se producen en ASMS?

    Sí, es posible. Se recomiendan los pasos siguientes:

    • Inicialice un desencadenador "Cuando se recibe una solicitud HTTP" y cree un esquema JSON del cuerpo de la solicitud que contiene la estructura de datos que se espera que se reciba de ASMS. Una vez creado el desencadenador, obtendrá una dirección URL HTTP POST (dirección URL de webHook) que se usará en la instancia de ASMS. No olvide tener en cuenta el mecanismo de autenticación para acceder a la dirección URL del webHook (por ejemplo, token).
    • Cree una regla de negocios en ASMS para el conjunto de condiciones que, cuando se cumplan, debe iniciar el flujo en Power Automate. Como acción dentro de la regla, seleccione "Invoke Webhook" (Invocar webhook) y, en la dirección URL de destino de invocación, escriba la dirección URL de webHook obtenida anteriormente, los parámetros que se van a enviar y el cuerpo de la solicitud (que debe coincidir con el esquema JSON del cuerpo de la solicitud). Para obtener más información sobre cómo invocar un webhook desde una regla en ASMS, visite el vínculo siguiente: Regla de webhook.
    • Pruebe la regla creada y valide que se envía una solicitud HTTP a la dirección URL del webHook e inicializa el flujo en Power Automate.
  9. ¿Puedo invocar puntos de conexión de la API REST de ASMS como acciones desde flujos en Power Automate?

    Sí, es posible. Use la acción "HTTP" y rellene los datos necesarios en él (URI, Método, Encabezados, Cuerpo, entre otros).

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Clave de API securestring La clave de API de esta API Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Actualiza un grupo con el identificador especificado.

Actualiza el nombre de un grupo mediante el identificador numérico del grupo. Si el identificador de grupo pasado no existe, se producirá un error en la llamada.

Actualizar el nombre de un panel específico

Actualiza un panel. Esto no cambia el número de teléfono de un panel. Si desea un nuevo número con los contactos de otro panel, tendrá que crear un nuevo panel con post y agregar los contactos con una exportación o importación masiva.

Archivar una conversación

Archiva una conversación, quitándola de los resultados de todos los puntos de conexión de recuperación de conversación. Una conversación se desarchivará automáticamente si el cliente envía un texto al número de solicitud de texto o si envía al cliente un texto del número de solicitud de texto. Archivar conversaciones es una buena manera de quitar el desorden de los clientes a los que no planea hablar en el futuro. Tenga en cuenta que si un cliente envía mensajes sms en "STOP" para evitar que envíe mensajes SMS adicionales, la conversación se archiva automáticamente.

Cancela el pago especificado.

Cancela el pago especificado, que indica al usuario que se ha cancelado el pago. Los pagos no se pueden editar, por lo que cancelar y emitir un nuevo pago es la mejor manera de corregir un pago.

Contactos de actualización masiva

Solo el panel especificado tendrá contactos agregados; los contactos se organizan por panel y no hay ninguna búsqueda de nivel de cuenta para un número disponible.

Crea un nuevo grupo

Crea un nuevo grupo con el nombre proporcionado.

Crea un nuevo pago

Crea un nuevo pago con el mensaje proporcionado al contacto proporcionado.

Crear o actualizar un contacto

Crea o actualiza un contacto (dependiendo de si ya existe uno con el número de teléfono especificado).

Crear un nuevo panel con el nombre y el número de teléfono especificados

Crea un nuevo panel en la cuenta. Una vez creado el panel, los administradores se enviarán por correo electrónico sobre el cambio y podrán empezar a asignar usuarios. Este punto de conexión puede hacer un panel para cualquier número aprovisionado. Puede buscar números aprovisionados en un código de área específico mediante GET /dashboards/provisioning. Si el número de teléfono ya está en uso, se producirá una excepción de solicitud incorrecta.

Desarchivar una conversación

Desarchiva una conversación. Una vez que se desarchive una conversación, aparecerá de nuevo en la cola. también aparecerá en las conversaciones devueltas por el punto de conexión /conversations. Si una conversación ya no está archivada, este método no tiene ningún efecto.

Elimina el contacto con el número de teléfono especificado.

Elimina el contacto con el número de teléfono especificado.

Elimina el grupo con el identificador especificado.

Elimina el grupo con el identificador especificado. Esto se realizará correctamente incluso si hay contactos que son miembros del grupo (los contactos no se eliminarán).

Elimina el panel especificado.

Elimina el panel especificado.

Enviar un mensaje al contacto con el número de teléfono especificado

Envía un mensaje (iniciando una nueva conversación si el número de teléfono especificado no tiene historial de mensajes).

Enviar un texto de seguimiento que recuerde al usuario que paga el pago especificado

Envía un aviso al contacto para pagar el pago especificado. El contenido del mensaje se genera automáticamente. Para evitar el correo no deseado, solo se puede enviar un aviso por pago

Marcar un pago como pagado

Cierra un pago como "pagado". Use este punto de conexión para cuando el pago se pague a través de un medio distinto del portal de solicitudes de pago. Esto cerrará el pago y agregará su importe de pago a sus estadísticas. Este punto de conexión no es necesario para los pagos pagados a través del portal de pagos enviado a través de la solicitud de texto; que marcará automáticamente un pago como pagado.

Obtener información sobre este panel específico

Devuelve el nombre y el teléfono del panel.

Obtener los mensajes de una conversación por el número de teléfono de un contacto

Obtenga la conversación entre el panel y el número de teléfono especificados.

Obtener todos los contactos que coincidan con el criterio de filtrado especificado

Obtiene todos los contactos que coinciden con el criterio de filtrado especificado. Solo se buscará en el panel especificado; no hay ninguna búsqueda de nivel de cuenta para un número disponible.

Obtener todos los paneles de una cuenta

Obtiene todos los paneles de una cuenta.

Obtener un grupo por su identificador

Obtiene el grupo con el identificador especificado.

Obtiene el contacto con el número de teléfono especificado.

Obtiene el contacto con el número de teléfono especificado.

Obtiene el pago con el identificador especificado.

Obtiene el pago con el identificador especificado.

Obtiene todas las conversaciones de este panel.

Obtiene todas las conversaciones de este panel e incluye información sobre el último mensaje de cada conversación.

Obtiene todas las etiquetas.

Obtiene todas las etiquetas de este panel. Las etiquetas son únicas entre paneles.

Obtiene todos los campos personalizados.

Obtiene todos los campos personalizados de este panel. Los campos personalizados son únicos entre paneles.

Obtiene todos los grupos.

Obtiene todos los grupos de la cuenta del usuario.

Obtiene todos los pagos

Obtiene todos los pagos, incluidos los pagos cancelados y pagados. Estos se pueden filtrar mediante los parámetros de consulta.

Actualiza un grupo con el identificador especificado.

Actualiza el nombre de un grupo mediante el identificador numérico del grupo. Si el identificador de grupo pasado no existe, se producirá un error en la llamada.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Identificador del grupo
group_id True integer

Identificador numérico del grupo que se va a actualizar.

Nombre del grupo
name string

Nuevo nombre del grupo.

Nota de grupo
notes string

Frase corta que describe el grupo. Se usa para mayor comodidad.

Devoluciones

Nombre Ruta de acceso Tipo Description
id
id integer

Identificador numérico del grupo.

group_member_count
group_member_count integer

Número de miembros del grupo.

is_keyword
is_keyword boolean

Wheter this group is a keyword group. Estos grupos se generan automáticamente cuando un usuario configura una palabra clave. Los contactos se agregan automáticamente cuando se inscriben.

nombre
name string

Nombre de este grupo.

notas
notes string

Cualquier nota de este grupo.

last_message_sent_utc
last_message_sent_utc string

Marca de tiempo de cuándo se envió el último mensaje de grupo para este grupo.

Actualizar el nombre de un panel específico

Actualiza un panel. Esto no cambia el número de teléfono de un panel. Si desea un nuevo número con los contactos de otro panel, tendrá que crear un nuevo panel con post y agregar los contactos con una exportación o importación masiva.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Nombre del panel
name string

Nuevo nombre del panel.

Devoluciones

Nombre Ruta de acceso Tipo Description
id
id integer

Identificador numérico del panel.

nombre
name string

Nombre del panel.

phone
phone string

Número de texto asociado a este panel.

Archivar una conversación

Archiva una conversación, quitándola de los resultados de todos los puntos de conexión de recuperación de conversación. Una conversación se desarchivará automáticamente si el cliente envía un texto al número de solicitud de texto o si envía al cliente un texto del número de solicitud de texto. Archivar conversaciones es una buena manera de quitar el desorden de los clientes a los que no planea hablar en el futuro. Tenga en cuenta que si un cliente envía mensajes sms en "STOP" para evitar que envíe mensajes SMS adicionales, la conversación se archiva automáticamente.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Número de teléfono de conversación
phone_number True string

Número de teléfono de la conversación que se va a archivar.

Devoluciones

response
string

Cancela el pago especificado.

Cancela el pago especificado, que indica al usuario que se ha cancelado el pago. Los pagos no se pueden editar, por lo que cancelar y emitir un nuevo pago es la mejor manera de corregir un pago.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Identificador del pago
payment_id True integer

Identificador numérico del pago que se va a actualizar.

Devoluciones

Nombre Ruta de acceso Tipo Description
payment_id
payment_id integer

Identificador numérico del pago.

request_date
request_date string

Marca de tiempo de cuándo se puso en cola el mensaje inicial de este pago para enviarse.

destinatario
recipient string

Nombre del destinatario del pago. Puede ser null si el contacto no tiene un nombre asociado a su número de teléfono.

descripción
description string

Descripción del pago. Esto no se muestra al contacto. Solo lo usan los usuarios internos para el contexto sobre los pagos.

customer_phone
customer_phone string

Número de teléfono del contacto que se envía este pago.

amount_requested
amount_requested float

Importe en dólares solicitados por este pago.

is_past_due
is_past_due boolean

Si este pago ha pasado la fecha de solicitud.

reminder_was_sent
reminder_was_sent boolean

Si ya se ha enviado un aviso de texto para este pago.

transaction_status
transaction_status string

Estado de la transacción en authvia. Este valor se inicia como Desconocido.

textrequest_payment_status
textrequest_payment_status string

Estado de la transacción en Solicitud de texto. Esto representa ese estado que se muestra en la página de pagos de la aplicación Solicitud de texto. Se inicia como Enviado.

reference_number
reference_number string

Identificador definido por el usuario cuando se crean pagos que se pueden usar para encontrar rápidamente los pagos. Los números de referencia no son únicos; muchos pagos pueden tener la misma referencia.

Contactos de actualización masiva

Solo el panel especificado tendrá contactos agregados; los contactos se organizan por panel y no hay ninguna búsqueda de nivel de cuenta para un número disponible.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Número de teléfono de contacto
phone_number string

Número de teléfono del contacto para crear o actualizar.

Nombre del contacto
first_name string

Nuevo nombre del contacto.

Apellidos de contacto
last_name string

Nuevo apellido del contacto.

Nombre completo del contacto
display_name string

Nuevo nombre completo del contacto. Este es el nombre predeterminado que se muestra en la aplicación web al ver los contactos.

Si se suprimen los mensajes de este contacto
is_suppressed boolean

Determina si se suprimen las conversaciones con este contacto y, por tanto, no se insertan en la parte superior de la cola de mensajes cuando se reciben.

Si se archivan los mensajes de este contacto
is_archived boolean

Determina si las conversaciones con este contacto se archivan y, por tanto, no se pueden ver al consultar conversaciones (de forma predeterminada).

Indica si los mensajes de este contacto están bloqueados
is_blocked boolean

Determina si las conversaciones con este contacto están bloqueadas y, por lo tanto, no se reciben o almacenan.

Motivo para suprimir este contacto
suppressed_reason string

Frase que describe el motivo para suprimir el contacto.

Nota de contacto
note string

Frase corta que describe el contacto. Se usa para mayor comodidad. Esto nunca se muestra al contacto.

Grupos de contactos
groups array of integer

Matriz de identificadores enteros que hacen referencia a grupos a los que pertenece este contacto.

Etiquetas de contacto
contact_tags array of string

Matriz de guides que hacen referencia a etiquetas adjuntas a este contacto.

Identificador de campo personalizado
id string

Guid que hace referencia a un campo personalizado.

Valor de campo personalizado
value string

El valor de este contacto para este campo personalizado.

Si se ha resuelto la conversación actual con este contacto
is_resolved boolean

Determina si se resuelve la conversación actual con este contacto. Los nuevos textos recibidos por este contacto establecerán este false.

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
número_de_teléfono
phone_number string

Número de teléfono de este contacto.

first_name
first_name string

Nombre de este contacto.

last_name
last_name string

Apellidos de este contacto.

display_name
display_name string

Nombre completo de este contacto. Este es el nombre predeterminado que se muestra en la aplicación web al ver los contactos.

is_suppressed
is_suppressed boolean

Si se suprime la conversación con este contacto y, por tanto, no se inserta en la parte superior de la cola de mensajes cuando se recibe.

is_archived
is_archived boolean

Si la conversación con este contacto se archiva y, por tanto, no se puede ver al consultar conversaciones (de forma predeterminada).

is_blocked
is_blocked boolean

Indica si la conversación con este contacto está bloqueada y, por tanto, no se recibe ni almacena.

suppressed_reason
suppressed_reason string

Frase que describe el motivo para suprimir el contacto. Si is_suppressed es false, será null.

nota
note string

Frase corta que describe el contacto. Se usa para mayor comodidad. Esto nunca se muestra al contacto.

groups
groups array of integer

Matriz de identificadores enteros a los que hace referencia a los grupos a los que pertenece este contacto.

contact_tags
contact_tags array of string

Matriz de guides que hacen referencia a etiquetas adjuntas a este contacto.

custom_fields
custom_fields array of object

Matriz de identificadores y valores de campo personalizados definidos para este contacto.

id
custom_fields.id string

Guid que hace referencia a un campo personalizado.

value
custom_fields.value string

El valor de este contacto para este campo personalizado.

is_resolved
is_resolved boolean

Si se resuelve la conversación con este contacto. Los nuevos textos recibidos por este contacto establecerán este false.

first_contact_utc
first_contact_utc string

Marca de tiempo de cuándo se envió el primer mensaje a este contacto.

opted_out_utc
opted_out_utc string

Marca de tiempo de cuando este contacto optó por no recibir mensajes.

last_msg_sent_utc
last_msg_sent_utc string

Marca de tiempo de cuándo se envió el último mensaje a este contacto.

last_msg_received_utc
last_msg_received_utc string

Marca de tiempo de cuando se recibió el último mensaje de este contacto.

total_msgs_sent
total_msgs_sent integer

Número de mensajes totales enviados a este contacto.

total_msgs_received
total_msgs_received integer

Número de mensajes totales recibidos de este contacto.

response_count
response_count integer

Número total de mensajes de respuesta del contacto.

date_created_utc
date_created_utc string

Marca de tiempo de cuándo se creó el contacto.

last_contact_date_utc
last_contact_date_utc string

Marca de tiempo de cuándo se envió o recibió el último mensaje de este contacto.

message_id
last_message.message_id string

Id. del mensaje. Este valor es único para cada mensaje.

body
last_message.body string

Contenido de este mensaje.

message_direction
last_message.message_direction string

Carácter singular, ya sea R o S, que indica si este mensaje se recibió del contacto o se les envió, respectivamente.

response_by_username
last_message.response_by_username string

Nombre de usuario del usuario solicitud de texto que envió por última vez un mensaje a este usuario.

message_timestamp_utc
last_message.message_timestamp_utc string

Marca de tiempo de cuando la solicitud de texto envió o recibió el mensaje.

delivery_status
last_message.delivery_status string

Estado actual de este mensaje. Esto puede ser "send", "delivered", "error" o "send".

delivery_error
last_message.delivery_error string

Error que provocó que este mensaje no se entregue. Si el delivery_status no es "error", este valor será NULL.

mms_media
last_message.mms_media array of string

Lista de direcciones URL que apuntan a los datos adjuntos de este mensaje. Todas las direcciones URL serán direcciones URL generadas por la solicitud de texto.

Crea un nuevo grupo

Crea un nuevo grupo con el nombre proporcionado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Nombre del grupo
name string

Nuevo nombre del grupo.

Nota de grupo
notes string

Frase corta que describe el grupo. Se usa para mayor comodidad.

Devoluciones

Nombre Ruta de acceso Tipo Description
id
id integer

Identificador numérico del grupo.

group_member_count
group_member_count integer

Número de miembros del grupo.

is_keyword
is_keyword boolean

Wheter this group is a keyword group. Estos grupos se generan automáticamente cuando un usuario configura una palabra clave. Los contactos se agregan automáticamente cuando se inscriben.

nombre
name string

Nombre de este grupo.

notas
notes string

Cualquier nota de este grupo.

last_message_sent_utc
last_message_sent_utc string

Marca de tiempo de cuándo se envió el último mensaje de grupo para este grupo.

Crea un nuevo pago

Crea un nuevo pago con el mensaje proporcionado al contacto proporcionado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Descripción del pago
description string

Descripción del pago. La descripción no se muestra al contacto y solo la usan los usuarios internos para el contexto sobre los pagos.

Número de teléfono del destinatario
customer_phone string

Número de teléfono del contacto al que se enviará este pago.

Importe solicitado en dólares
amount_requested float

Importe en dólares solicitados por este pago.

Cuerpo del texto del mensaje de pago
message string

Texto del mensaje que se va a enviar al contacto junto con el vínculo de pago.

Cadena de referencia del pago
reference_number string

Identificador definido por el usuario cuando se crean pagos que se pueden usar para encontrar rápidamente pagos. Los números de referencia no son únicos; muchos pagos pueden tener la misma referencia.

Devoluciones

Nombre Ruta de acceso Tipo Description
payment_id
payment_id integer

Identificador numérico del pago.

request_date
request_date string

Marca de tiempo de cuándo se puso en cola el mensaje inicial de este pago para enviarse.

destinatario
recipient string

Nombre del destinatario del pago. Puede ser null si el contacto no tiene un nombre asociado a su número de teléfono.

descripción
description string

Descripción del pago. Esto no se muestra al contacto. Solo lo usan los usuarios internos para el contexto sobre los pagos.

customer_phone
customer_phone string

Número de teléfono del contacto que se envía este pago.

amount_requested
amount_requested float

Importe en dólares solicitados por este pago.

is_past_due
is_past_due boolean

Si este pago ha pasado la fecha de solicitud.

reminder_was_sent
reminder_was_sent boolean

Si ya se ha enviado un aviso de texto para este pago.

transaction_status
transaction_status string

Estado de la transacción en authvia. Este valor se inicia como Desconocido.

textrequest_payment_status
textrequest_payment_status string

Estado de la transacción en Solicitud de texto. Esto representa ese estado que se muestra en la página de pagos de la aplicación Solicitud de texto. Se inicia como Enviado.

reference_number
reference_number string

Identificador definido por el usuario cuando se crean pagos que se pueden usar para encontrar rápidamente los pagos. Los números de referencia no son únicos; muchos pagos pueden tener la misma referencia.

Crear o actualizar un contacto

Crea o actualiza un contacto (dependiendo de si ya existe uno con el número de teléfono especificado).

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Número de teléfono de contacto
phone_number True string

Número de teléfono del contacto para crear o actualizar.

Nombre del contacto
first_name string

Nuevo nombre del contacto.

Apellidos de contacto
last_name string

Nuevo apellido del contacto.

Nombre completo del contacto
display_name string

Nuevo nombre completo del contacto. Este es el nombre predeterminado que se muestra en la aplicación web al ver los contactos.

Si se suprimen los mensajes de este contacto
is_suppressed boolean

Determina si se suprimen las conversaciones con este contacto y, por tanto, no se insertan en la parte superior de la cola de mensajes cuando se reciben.

Si se archivan los mensajes de este contacto
is_archived boolean

Determina si las conversaciones con este contacto se archivan y, por tanto, no se pueden ver al consultar conversaciones (de forma predeterminada).

Indica si los mensajes de este contacto están bloqueados
is_blocked boolean

Determina si las conversaciones con este contacto están bloqueadas y, por lo tanto, no se reciben o almacenan.

Motivo para suprimir este contacto
suppressed_reason string

Frase que describe el motivo para suprimir el contacto.

Nota de contacto
note string

Frase corta que describe el contacto. Se usa para mayor comodidad. Esto nunca se muestra al contacto.

Grupos de contactos
groups array of integer

Matriz de identificadores enteros que hacen referencia a grupos a los que pertenece este contacto.

Etiquetas de contacto
contact_tags array of string

Matriz de guides que hacen referencia a etiquetas adjuntas a este contacto.

Identificador de campo personalizado
id string

Guid que hace referencia a un campo personalizado.

Valor de campo personalizado
value string

El valor de este contacto para este campo personalizado.

Si se ha resuelto la conversación actual con este contacto
is_resolved boolean

Determina si se resuelve la conversación actual con este contacto. Los nuevos textos recibidos por este contacto establecerán este false.

Devoluciones

Nombre Ruta de acceso Tipo Description
número_de_teléfono
phone_number string

Número de teléfono de este contacto.

first_name
first_name string

Nombre de este contacto.

last_name
last_name string

Apellidos de este contacto.

display_name
display_name string

Nombre completo de este contacto. Este es el nombre predeterminado que se muestra en la aplicación web al ver los contactos.

is_suppressed
is_suppressed boolean

Si se suprime la conversación con este contacto y, por tanto, no se inserta en la parte superior de la cola de mensajes cuando se recibe.

is_archived
is_archived boolean

Si la conversación con este contacto se archiva y, por tanto, no se puede ver al consultar conversaciones (de forma predeterminada).

is_blocked
is_blocked boolean

Indica si la conversación con este contacto está bloqueada y, por tanto, no se recibe ni almacena.

suppressed_reason
suppressed_reason string

Frase que describe el motivo para suprimir el contacto. Si is_suppressed es false, será null.

nota
note string

Frase corta que describe el contacto. Se usa para mayor comodidad. Esto nunca se muestra al contacto.

groups
groups array of integer

Matriz de identificadores enteros a los que hace referencia a los grupos a los que pertenece este contacto.

contact_tags
contact_tags array of string

Matriz de guides que hacen referencia a etiquetas adjuntas a este contacto.

custom_fields
custom_fields array of object

Matriz de identificadores y valores de campo personalizados definidos para este contacto.

id
custom_fields.id string

Guid que hace referencia a un campo personalizado.

value
custom_fields.value string

El valor de este contacto para este campo personalizado.

is_resolved
is_resolved boolean

Si se resuelve la conversación con este contacto. Los nuevos textos recibidos por este contacto establecerán este false.

first_contact_utc
first_contact_utc string

Marca de tiempo de cuándo se envió el primer mensaje a este contacto.

opted_out_utc
opted_out_utc string

Marca de tiempo de cuando este contacto optó por no recibir mensajes.

last_msg_sent_utc
last_msg_sent_utc string

Marca de tiempo de cuándo se envió el último mensaje a este contacto.

last_msg_received_utc
last_msg_received_utc string

Marca de tiempo de cuando se recibió el último mensaje de este contacto.

total_msgs_sent
total_msgs_sent integer

Número de mensajes totales enviados a este contacto.

total_msgs_received
total_msgs_received integer

Número de mensajes totales recibidos de este contacto.

response_count
response_count integer

Número total de mensajes de respuesta del contacto.

date_created_utc
date_created_utc string

Marca de tiempo de cuándo se creó el contacto.

last_contact_date_utc
last_contact_date_utc string

Marca de tiempo de cuándo se envió o recibió el último mensaje de este contacto.

message_id
last_message.message_id string

Id. del mensaje. Este valor es único para cada mensaje.

body
last_message.body string

Contenido de este mensaje.

message_direction
last_message.message_direction string

Carácter singular, ya sea R o S, que indica si este mensaje se recibió del contacto o se les envió, respectivamente.

response_by_username
last_message.response_by_username string

Nombre de usuario del usuario solicitud de texto que envió por última vez un mensaje a este usuario.

message_timestamp_utc
last_message.message_timestamp_utc string

Marca de tiempo de cuando la solicitud de texto envió o recibió el mensaje.

delivery_status
last_message.delivery_status string

Estado actual de este mensaje. Esto puede ser "send", "delivered", "error" o "send".

delivery_error
last_message.delivery_error string

Error que provocó que este mensaje no se entregue. Si el delivery_status no es "error", este valor será NULL.

mms_media
last_message.mms_media array of string

Lista de direcciones URL que apuntan a los datos adjuntos de este mensaje. Todas las direcciones URL serán direcciones URL generadas por la solicitud de texto.

Crear un nuevo panel con el nombre y el número de teléfono especificados

Crea un nuevo panel en la cuenta. Una vez creado el panel, los administradores se enviarán por correo electrónico sobre el cambio y podrán empezar a asignar usuarios. Este punto de conexión puede hacer un panel para cualquier número aprovisionado. Puede buscar números aprovisionados en un código de área específico mediante GET /dashboards/provisioning. Si el número de teléfono ya está en uso, se producirá una excepción de solicitud incorrecta.

Parámetros

Nombre Clave Requerido Tipo Description
nombre
name string

Nombre del panel.

phone
phone string

Número de texto asociado a este panel.

Devoluciones

Nombre Ruta de acceso Tipo Description
id
id integer

Identificador numérico del panel.

nombre
name string

Nombre del panel.

phone
phone string

Número de texto asociado a este panel.

Desarchivar una conversación

Desarchiva una conversación. Una vez que se desarchive una conversación, aparecerá de nuevo en la cola. también aparecerá en las conversaciones devueltas por el punto de conexión /conversations. Si una conversación ya no está archivada, este método no tiene ningún efecto.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Número de teléfono de conversación
phone_number True string

Número de teléfono de la conversación que se va a archivar.

Devoluciones

response
string

Elimina el contacto con el número de teléfono especificado.

Elimina el contacto con el número de teléfono especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Número de teléfono de contacto
phone_number True string

Número de teléfono del contacto que se va a eliminar.

Devoluciones

response
string

Elimina el grupo con el identificador especificado.

Elimina el grupo con el identificador especificado. Esto se realizará correctamente incluso si hay contactos que son miembros del grupo (los contactos no se eliminarán).

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Identificador del grupo
group_id True integer

Identificador numérico del grupo que se va a eliminar.

Devoluciones

response
string

Elimina el panel especificado.

Elimina el panel especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Devoluciones

response
string

Enviar un mensaje al contacto con el número de teléfono especificado

Envía un mensaje (iniciando una nueva conversación si el número de teléfono especificado no tiene historial de mensajes).

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Número de teléfono al mensaje
phone_number True string

Número de teléfono del contacto al que enviar un mensaje.

Cuerpo del mensaje
body string

Contenido del mensaje que se va a enviar.

Nombre del remitente
sender_name string

Nombre del remitente del mensaje. Esto se muestra en la api y la aplicación web TextRequest al recuperar este mensaje.

Dirección URL de devolución de llamada para cuando se actualiza el estado del mensaje
status_callback string

Dirección URL de la aplicación web que se va a alcanzar con un comando POST cada vez que el estado de este mensaje pasa de no entregado a enviado (o error).

Dirección URL de devolución de llamada para las solicitudes de ubicación si este mensaje incluye uno
location_callback string

Dirección URL de devolución de llamada de ubicación que se va a alcanzar con un comando POST cuando el usuario accede a y aprueba compartir su ubicación con el remitente. Para incluir el vínculo, agregue [Solicitud de ubicación] al cuerpo del mensaje. Esta devolución de llamada no es necesaria para las solicitudes de ubicación, pero puede ser útil para las API.

Datos adjuntos multimedia mmS para este mensaje
mms_media array of string

Matriz de datos adjuntos multimedia MMS para este mensaje. Los datos adjuntos deben ser direcciones URL que se obtienen del punto de conexión posterior a /mms (no se incluye en este conector). No se aceptarán vínculos de datos adjuntos externos.

Devoluciones

Nombre Ruta de acceso Tipo Description
message_id
message_id string

Id. del mensaje. Este valor es único para cada mensaje.

body
body string

Contenido de este mensaje.

message_direction
message_direction string

Carácter singular, ya sea R o S, que indica si este mensaje se recibió del contacto o se les envió, respectivamente.

response_by_username
response_by_username string

Nombre de usuario del usuario solicitud de texto que envió por última vez un mensaje a este usuario.

message_timestamp_utc
message_timestamp_utc string

Marca de tiempo de cuando la solicitud de texto envió o recibió el mensaje.

delivery_status
delivery_status string

Estado actual de este mensaje. Esto puede ser "send", "delivered", "error" o "send".

delivery_error
delivery_error string

Error que provocó que este mensaje no se entregue. Si el delivery_status no es "error", este valor será NULL.

mms_media
mms_media array of string

Lista de direcciones URL que apuntan a los datos adjuntos de este mensaje. Todas las direcciones URL serán direcciones URL generadas por la solicitud de texto.

Enviar un texto de seguimiento que recuerde al usuario que paga el pago especificado

Envía un aviso al contacto para pagar el pago especificado. El contenido del mensaje se genera automáticamente. Para evitar el correo no deseado, solo se puede enviar un aviso por pago

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Identificador del pago
payment_id True integer

Identificador numérico del pago que se va a actualizar.

Devoluciones

Nombre Ruta de acceso Tipo Description
payment_id
payment_id integer

Identificador numérico del pago.

request_date
request_date string

Marca de tiempo de cuándo se puso en cola el mensaje inicial de este pago para enviarse.

destinatario
recipient string

Nombre del destinatario del pago. Puede ser null si el contacto no tiene un nombre asociado a su número de teléfono.

descripción
description string

Descripción del pago. Esto no se muestra al contacto. Solo lo usan los usuarios internos para el contexto sobre los pagos.

customer_phone
customer_phone string

Número de teléfono del contacto que se envía este pago.

amount_requested
amount_requested float

Importe en dólares solicitados por este pago.

is_past_due
is_past_due boolean

Si este pago ha pasado la fecha de solicitud.

reminder_was_sent
reminder_was_sent boolean

Si ya se ha enviado un aviso de texto para este pago.

transaction_status
transaction_status string

Estado de la transacción en authvia. Este valor se inicia como Desconocido.

textrequest_payment_status
textrequest_payment_status string

Estado de la transacción en Solicitud de texto. Esto representa ese estado que se muestra en la página de pagos de la aplicación Solicitud de texto. Se inicia como Enviado.

reference_number
reference_number string

Identificador definido por el usuario cuando se crean pagos que se pueden usar para encontrar rápidamente los pagos. Los números de referencia no son únicos; muchos pagos pueden tener la misma referencia.

Marcar un pago como pagado

Cierra un pago como "pagado". Use este punto de conexión para cuando el pago se pague a través de un medio distinto del portal de solicitudes de pago. Esto cerrará el pago y agregará su importe de pago a sus estadísticas. Este punto de conexión no es necesario para los pagos pagados a través del portal de pagos enviado a través de la solicitud de texto; que marcará automáticamente un pago como pagado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Identificador del pago
payment_id True integer

Identificador numérico del pago que se va a actualizar.

Devoluciones

Nombre Ruta de acceso Tipo Description
payment_id
payment_id integer

Identificador numérico del pago.

request_date
request_date string

Marca de tiempo de cuándo se puso en cola el mensaje inicial de este pago para enviarse.

destinatario
recipient string

Nombre del destinatario del pago. Puede ser null si el contacto no tiene un nombre asociado a su número de teléfono.

descripción
description string

Descripción del pago. Esto no se muestra al contacto. Solo lo usan los usuarios internos para el contexto sobre los pagos.

customer_phone
customer_phone string

Número de teléfono del contacto que se envía este pago.

amount_requested
amount_requested float

Importe en dólares solicitados por este pago.

is_past_due
is_past_due boolean

Si este pago ha pasado la fecha de solicitud.

reminder_was_sent
reminder_was_sent boolean

Si ya se ha enviado un aviso de texto para este pago.

transaction_status
transaction_status string

Estado de la transacción en authvia. Este valor se inicia como Desconocido.

textrequest_payment_status
textrequest_payment_status string

Estado de la transacción en Solicitud de texto. Esto representa ese estado que se muestra en la página de pagos de la aplicación Solicitud de texto. Se inicia como Enviado.

reference_number
reference_number string

Identificador definido por el usuario cuando se crean pagos que se pueden usar para encontrar rápidamente los pagos. Los números de referencia no son únicos; muchos pagos pueden tener la misma referencia.

Obtener información sobre este panel específico

Devuelve el nombre y el teléfono del panel.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Devoluciones

Nombre Ruta de acceso Tipo Description
id
id integer

Identificador numérico del panel.

nombre
name string

Nombre del panel.

phone
phone string

Número de texto asociado a este panel.

Obtener los mensajes de una conversación por el número de teléfono de un contacto

Obtenga la conversación entre el panel y el número de teléfono especificados.

Parámetros

Nombre Clave Requerido Tipo Description
Página número que se va a obtener
page True integer

Página de entidades que se van a obtener. Al obtener valores, hay un tamaño máximo por página, definido por page_size. Si la página es mayor que la última página, se devolverá una matriz vacía.

Cantidad de cada entidad que se va a obtener por página
page_size True integer

Tamaño de cada página que se va a obtener. Al obtener valores, se trata de un tamaño máximo por página, con acceso a las páginas posteriores realizadas por el parámetro page.

Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Número de teléfono del contacto para buscar por
phone_number True string

Número de teléfono del contacto para el que se van a obtener mensajes.

Devoluciones

Nombre Ruta de acceso Tipo Description
página
meta.page integer

Página de entidades que se han obtenido. La cantidad de entidades de esta página se define mediante page_size.

page_size
meta.page_size integer

Número de entidades que se han obtenido en esta página.

total_items
meta.total_items integer

Número de entidades disponibles en la base de datos, independientemente del tamaño o número de página. Para ver las otras páginas, cambie el número de página de la solicitud.

items
items array of object

Lista de entidades de mensaje que se han obtenido de la solicitud de texto.

message_id
items.message_id string

Id. del mensaje. Este valor es único para cada mensaje.

body
items.body string

Contenido de este mensaje.

message_direction
items.message_direction string

Carácter singular, ya sea R o S, que indica si este mensaje se recibió del contacto o se les envió, respectivamente.

response_by_username
items.response_by_username string

Nombre de usuario del usuario solicitud de texto que envió por última vez un mensaje a este usuario.

message_timestamp_utc
items.message_timestamp_utc string

Marca de tiempo de cuando la solicitud de texto envió o recibió el mensaje.

delivery_status
items.delivery_status string

Estado actual de este mensaje. Esto puede ser "send", "delivered", "error" o "send".

delivery_error
items.delivery_error string

Error que provocó que este mensaje no se entregue. Si el delivery_status no es "error", este valor será NULL.

mms_media
items.mms_media array of string

Lista de direcciones URL que apuntan a los datos adjuntos de este mensaje. Todas las direcciones URL serán direcciones URL generadas por la solicitud de texto.

Obtener todos los contactos que coincidan con el criterio de filtrado especificado

Obtiene todos los contactos que coinciden con el criterio de filtrado especificado. Solo se buscará en el panel especificado; no hay ninguna búsqueda de nivel de cuenta para un número disponible.

Parámetros

Nombre Clave Requerido Tipo Description
Número de teléfono del contacto para buscar por
contact_phone_number string

Número de teléfono por el que se van a filtrar los contactos.

"Hora del último mensaje enviada antes" de la marca de tiempo de búsqueda en hora UTC
last_message_timestamp_before_utc date-time

Tiempo límite para buscar contactos por el último mensaje enviado o recibido. No se mostrarán contactos que envíen mensajes después de este tiempo.

"Hora del último mensaje enviado después de" marca de tiempo de búsqueda en hora UTC
last_message_timestamp_after_utc date-time

Tiempo límite para buscar contactos por el último mensaje enviado o recibido. No se mostrará ningún contacto cuyo último mensaje enviado esté antes de esta hora.

Marca de tiempo de búsqueda "Creado antes"
contact_created_before date-time

Tiempo límite para buscar contactos por cuando se crearon. No se mostrará ningún contacto creado después de este tiempo.

Marca de tiempo de búsqueda "Creado después"
contact_created_after date-time

Tiempo límite para buscar contactos por cuando se crearon. No se mostrará ningún contacto creado antes de esta hora.

Si se resuelve la conversación del contacto
is_resolved boolean

Si se buscan contactos cuyas conversaciones se han resuelto.

Indica si el contacto está bloqueado
is_blocked boolean

Si se deben buscar contactos bloqueados.

Si el contacto está archivado
is_archived boolean

Si se van a buscar contactos que se han archivado.

Si se suprime el contacto
is_suppressed boolean

Si se van a buscar contactos que se han suprimido.

Si el contacto ha optado por no participar
has_opted_out boolean

Si desea buscar contactos que hayan optado por no recibir textos.

Marca de tiempo de búsqueda "Última hora del mensaje enviada antes"
last_message_sent_before date-time

Tiempo de interrupción de la búsqueda de contactos por el momento en que se envió el último mensaje al cliente. No se mostrarán contactos que envíen mensajes después de este tiempo. Usa la marca de tiempo como hora local. Para filtrar por marca de tiempo en hora UTC, use last_message_sent_before_utc

Marca de tiempo de búsqueda "Hora del último mensaje enviada después"
last_message_sent_after date-time

Tiempo de interrupción de la búsqueda de contactos por el momento en que se envió el último mensaje al cliente. No se mostrará ningún contacto cuyo último mensaje enviado esté antes de esta hora. Usa la marca de tiempo como hora local. Para filtrar por marca de tiempo en hora UTC, use last_message_sent_after_utc

Marca de tiempo de búsqueda "Hora del último mensaje recibida antes"
last_message_received_before date-time

Tiempo límite para buscar contactos por el último mensaje recibido del cliente. No se mostrará ningún contacto que haya recibido mensajes después de este tiempo. Usa la marca de tiempo como hora local. Para filtrar por marca de tiempo en hora UTC, use last_message_sent_before_utc

"Hora del último mensaje recibido después de" marca de tiempo de búsqueda
last_message_received_after date-time

Tiempo límite para buscar contactos por el último mensaje recibido del cliente. No se mostrará ningún contacto cuyo último mensaje enviado esté antes de esta hora. Usa la marca de tiempo como hora local. Para filtrar por marca de tiempo en hora UTC, use last_message_sent_before_utc

Etiquetas de contacto
tags string

Lista separada por comas de guides que hacen referencia a etiquetas para filtrar contactos por.

Grupos de contactos
groups string

Lista separada por comas de identificadores enteros que hacen referencia a grupos por los que filtrar los contactos.

Identificador del campo personalizado por el que se va a filtrar
custom_field_id_1 string

Guid que hace referencia al campo personalizado para filtrar contactos por.

Valor del campo personalizado por el que se va a filtrar
custom_field_value_1 string

Valor que hace referencia al campo personalizado para filtrar contactos por.

Identificador del segundo campo personalizado por el que filtrar
custom_field_id_2 string

Guid que hace referencia al segundo campo personalizado para filtrar contactos por.

Valor del segundo campo personalizado por el que se va a filtrar
custom_field_value_2 string

Valor que hace referencia al segundo campo personalizado para filtrar contactos por.

Identificador del tercer campo personalizado por el que se va a filtrar
custom_field_id_3 string

Guid que hace referencia al tercer campo personalizado para filtrar contactos por.

Valor de tercer campo personalizado por el que se va a filtrar
custom_field_value_3 string

Valor que hace referencia al tercer campo personalizado para filtrar contactos por.

Página número que se va a obtener
page True integer

Página de entidades que se van a obtener. Al obtener valores, hay un tamaño máximo por página, definido por page_size. Si la página es mayor que la última página, se devolverá una matriz vacía.

Cantidad de cada entidad que se va a obtener por página
page_size True integer

Tamaño de cada página que se va a obtener. Al obtener valores, se trata de un tamaño máximo por página, con acceso a las páginas posteriores realizadas por el parámetro page.

Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Devoluciones

Nombre Ruta de acceso Tipo Description
página
meta.page integer

Página de entidades que se han obtenido. La cantidad de entidades de esta página se define mediante page_size.

page_size
meta.page_size integer

Número de entidades que se han obtenido en esta página.

total_items
meta.total_items integer

Número de entidades disponibles en la base de datos, independientemente del tamaño o número de página. Para ver las otras páginas, cambie el número de página de la solicitud.

items
items array of object

Lista de entidades de contacto que se han obtenido de la solicitud de texto.

número_de_teléfono
items.phone_number string

Número de teléfono de este contacto.

first_name
items.first_name string

Nombre de este contacto.

last_name
items.last_name string

Apellidos de este contacto.

display_name
items.display_name string

Nombre completo de este contacto. Este es el nombre predeterminado que se muestra en la aplicación web al ver los contactos.

is_suppressed
items.is_suppressed boolean

Si se suprime la conversación con este contacto y, por tanto, no se inserta en la parte superior de la cola de mensajes cuando se recibe.

is_archived
items.is_archived boolean

Si la conversación con este contacto se archiva y, por tanto, no se puede ver al consultar conversaciones (de forma predeterminada).

is_blocked
items.is_blocked boolean

Indica si la conversación con este contacto está bloqueada y, por tanto, no se recibe ni almacena.

suppressed_reason
items.suppressed_reason string

Frase que describe el motivo para suprimir el contacto. Si is_suppressed es false, será null.

nota
items.note string

Frase corta que describe el contacto. Se usa para mayor comodidad. Esto nunca se muestra al contacto.

groups
items.groups array of integer

Matriz de identificadores enteros a los que hace referencia a los grupos a los que pertenece este contacto.

contact_tags
items.contact_tags array of string

Matriz de guides que hacen referencia a etiquetas adjuntas a este contacto.

custom_fields
items.custom_fields array of object

Matriz de identificadores y valores de campo personalizados definidos para este contacto.

id
items.custom_fields.id string

Guid que hace referencia a un campo personalizado.

value
items.custom_fields.value string

El valor de este contacto para este campo personalizado.

is_resolved
items.is_resolved boolean

Si se resuelve la conversación con este contacto. Los nuevos textos recibidos por este contacto establecerán este false.

first_contact_utc
items.first_contact_utc string

Marca de tiempo de cuándo se envió el primer mensaje a este contacto.

opted_out_utc
items.opted_out_utc string

Marca de tiempo de cuando este contacto optó por no recibir mensajes.

last_msg_sent_utc
items.last_msg_sent_utc string

Marca de tiempo de cuándo se envió el último mensaje a este contacto.

last_msg_received_utc
items.last_msg_received_utc string

Marca de tiempo de cuando se recibió el último mensaje de este contacto.

total_msgs_sent
items.total_msgs_sent integer

Número de mensajes totales enviados a este contacto.

total_msgs_received
items.total_msgs_received integer

Número de mensajes totales recibidos de este contacto.

response_count
items.response_count integer

Número total de mensajes de respuesta del contacto.

date_created_utc
items.date_created_utc string

Marca de tiempo de cuándo se creó el contacto.

last_contact_date_utc
items.last_contact_date_utc string

Marca de tiempo de cuándo se envió o recibió el último mensaje de este contacto.

message_id
items.last_message.message_id string

Id. del mensaje. Este valor es único para cada mensaje.

body
items.last_message.body string

Contenido de este mensaje.

message_direction
items.last_message.message_direction string

Carácter singular, ya sea R o S, que indica si este mensaje se recibió del contacto o se les envió, respectivamente.

response_by_username
items.last_message.response_by_username string

Nombre de usuario del usuario solicitud de texto que envió por última vez un mensaje a este usuario.

message_timestamp_utc
items.last_message.message_timestamp_utc string

Marca de tiempo de cuando la solicitud de texto envió o recibió el mensaje.

delivery_status
items.last_message.delivery_status string

Estado actual de este mensaje. Esto puede ser "send", "delivered", "error" o "send".

delivery_error
items.last_message.delivery_error string

Error que provocó que este mensaje no se entregue. Si el delivery_status no es "error", este valor será NULL.

mms_media
items.last_message.mms_media array of string

Lista de direcciones URL que apuntan a los datos adjuntos de este mensaje. Todas las direcciones URL serán direcciones URL generadas por la solicitud de texto.

Obtener todos los paneles de una cuenta

Obtiene todos los paneles de una cuenta.

Parámetros

Nombre Clave Requerido Tipo Description
Página número que se va a obtener
page integer

Página de entidades que se van a obtener. Al obtener valores, hay un tamaño máximo por página, definido por page_size. Si la página es mayor que la última página, se devolverá una matriz vacía.

Cantidad de cada entidad que se va a obtener por página
page_size integer

Tamaño de cada página que se va a obtener. Al obtener valores, se trata de un tamaño máximo por página, con acceso a las páginas posteriores realizadas por el parámetro page.

Devoluciones

Nombre Ruta de acceso Tipo Description
página
meta.page integer

Página de entidades que se han obtenido. La cantidad de entidades de esta página se define mediante page_size.

page_size
meta.page_size integer

Número de entidades que se han obtenido en esta página.

total_items
meta.total_items integer

Número de entidades disponibles en la base de datos, independientemente del tamaño o número de página. Para ver las otras páginas, cambie el número de página de la solicitud.

items
items array of object

Lista de entidades de panel que se han obtenido de la solicitud de texto.

id
items.id integer

Identificador numérico del panel.

nombre
items.name string

Nombre del panel.

phone
items.phone string

Número de texto asociado a este panel.

Obtener un grupo por su identificador

Obtiene el grupo con el identificador especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Identificador del grupo
group_id True integer

Identificador numérico del grupo que se va a obtener.

Devoluciones

Nombre Ruta de acceso Tipo Description
id
id integer

Identificador numérico del grupo.

group_member_count
group_member_count integer

Número de miembros del grupo.

is_keyword
is_keyword boolean

Wheter this group is a keyword group. Estos grupos se generan automáticamente cuando un usuario configura una palabra clave. Los contactos se agregan automáticamente cuando se inscriben.

nombre
name string

Nombre de este grupo.

notas
notes string

Cualquier nota de este grupo.

last_message_sent_utc
last_message_sent_utc string

Marca de tiempo de cuándo se envió el último mensaje de grupo para este grupo.

Obtiene el contacto con el número de teléfono especificado.

Obtiene el contacto con el número de teléfono especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Número de teléfono del contacto
phone_number True string

Número de teléfono del contacto que se va a obtener.

Devoluciones

Nombre Ruta de acceso Tipo Description
número_de_teléfono
phone_number string

Número de teléfono de este contacto.

first_name
first_name string

Nombre de este contacto.

last_name
last_name string

Apellidos de este contacto.

display_name
display_name string

Nombre completo de este contacto. Este es el nombre predeterminado que se muestra en la aplicación web al ver los contactos.

is_suppressed
is_suppressed boolean

Si se suprime la conversación con este contacto y, por tanto, no se inserta en la parte superior de la cola de mensajes cuando se recibe.

is_archived
is_archived boolean

Si la conversación con este contacto se archiva y, por tanto, no se puede ver al consultar conversaciones (de forma predeterminada).

is_blocked
is_blocked boolean

Indica si la conversación con este contacto está bloqueada y, por tanto, no se recibe ni almacena.

suppressed_reason
suppressed_reason string

Frase que describe el motivo para suprimir el contacto. Si is_suppressed es false, será null.

nota
note string

Frase corta que describe el contacto. Se usa para mayor comodidad. Esto nunca se muestra al contacto.

groups
groups array of integer

Matriz de identificadores enteros a los que hace referencia a los grupos a los que pertenece este contacto.

contact_tags
contact_tags array of string

Matriz de guides que hacen referencia a etiquetas adjuntas a este contacto.

custom_fields
custom_fields array of object

Matriz de identificadores y valores de campo personalizados definidos para este contacto.

id
custom_fields.id string

Guid que hace referencia a un campo personalizado.

value
custom_fields.value string

El valor de este contacto para este campo personalizado.

is_resolved
is_resolved boolean

Si se resuelve la conversación con este contacto. Los nuevos textos recibidos por este contacto establecerán este false.

first_contact_utc
first_contact_utc string

Marca de tiempo de cuándo se envió el primer mensaje a este contacto.

opted_out_utc
opted_out_utc string

Marca de tiempo de cuando este contacto optó por no recibir mensajes.

last_msg_sent_utc
last_msg_sent_utc string

Marca de tiempo de cuándo se envió el último mensaje a este contacto.

last_msg_received_utc
last_msg_received_utc string

Marca de tiempo de cuando se recibió el último mensaje de este contacto.

total_msgs_sent
total_msgs_sent integer

Número de mensajes totales enviados a este contacto.

total_msgs_received
total_msgs_received integer

Número de mensajes totales recibidos de este contacto.

response_count
response_count integer

Número total de mensajes de respuesta del contacto.

date_created_utc
date_created_utc string

Marca de tiempo de cuándo se creó el contacto.

last_contact_date_utc
last_contact_date_utc string

Marca de tiempo de cuándo se envió o recibió el último mensaje de este contacto.

message_id
last_message.message_id string

Id. del mensaje. Este valor es único para cada mensaje.

body
last_message.body string

Contenido de este mensaje.

message_direction
last_message.message_direction string

Carácter singular, ya sea R o S, que indica si este mensaje se recibió del contacto o se les envió, respectivamente.

response_by_username
last_message.response_by_username string

Nombre de usuario del usuario solicitud de texto que envió por última vez un mensaje a este usuario.

message_timestamp_utc
last_message.message_timestamp_utc string

Marca de tiempo de cuando la solicitud de texto envió o recibió el mensaje.

delivery_status
last_message.delivery_status string

Estado actual de este mensaje. Esto puede ser "send", "delivered", "error" o "send".

delivery_error
last_message.delivery_error string

Error que provocó que este mensaje no se entregue. Si el delivery_status no es "error", este valor será NULL.

mms_media
last_message.mms_media array of string

Lista de direcciones URL que apuntan a los datos adjuntos de este mensaje. Todas las direcciones URL serán direcciones URL generadas por la solicitud de texto.

Obtiene el pago con el identificador especificado.

Obtiene el pago con el identificador especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Identificador del pago
payment_id True integer

Identificador numérico del pago que se va a obtener.

Devoluciones

Nombre Ruta de acceso Tipo Description
payment_id
payment_id integer

Identificador numérico del pago.

request_date
request_date string

Marca de tiempo de cuándo se puso en cola el mensaje inicial de este pago para enviarse.

destinatario
recipient string

Nombre del destinatario del pago. Puede ser null si el contacto no tiene un nombre asociado a su número de teléfono.

descripción
description string

Descripción del pago. Esto no se muestra al contacto. Solo lo usan los usuarios internos para el contexto sobre los pagos.

customer_phone
customer_phone string

Número de teléfono del contacto que se envía este pago.

amount_requested
amount_requested float

Importe en dólares solicitados por este pago.

is_past_due
is_past_due boolean

Si este pago ha pasado la fecha de solicitud.

reminder_was_sent
reminder_was_sent boolean

Si ya se ha enviado un aviso de texto para este pago.

transaction_status
transaction_status string

Estado de la transacción en authvia. Este valor se inicia como Desconocido.

textrequest_payment_status
textrequest_payment_status string

Estado de la transacción en Solicitud de texto. Esto representa ese estado que se muestra en la página de pagos de la aplicación Solicitud de texto. Se inicia como Enviado.

reference_number
reference_number string

Identificador definido por el usuario cuando se crean pagos que se pueden usar para encontrar rápidamente los pagos. Los números de referencia no son únicos; muchos pagos pueden tener la misma referencia.

Obtiene todas las conversaciones de este panel.

Obtiene todas las conversaciones de este panel e incluye información sobre el último mensaje de cada conversación.

Parámetros

Nombre Clave Requerido Tipo Description
Etiquetas de contacto
tags string

Lista separada por comas de guides que hacen referencia a etiquetas para filtrar conversaciones por.

Indica si solo se muestran las conversaciones resueltas
show_unresolved_only string

Si solo se buscan contactos cuyas conversaciones se han resuelto. Si se trata de false, se mostrarán las conversaciones resueltas y sin resolver.

Si se deben incluir conversaciones archivadas
include_archived string

Si se deben incluir conversaciones con contactos que se han archivado.

Término para filtrar por números de teléfono y nombre de contacto
search string

Término de búsqueda para filtrar conversaciones por número de teléfono o nombre para mostrar. Si el término de búsqueda es menor que un nombre completo o un número de teléfono, la búsqueda devolverá todas las conversaciones que coincidan parcialmente.

Página número que se va a obtener
page integer

Página de entidades que se van a obtener. Al obtener valores, hay un tamaño máximo por página, definido por page_size. Si la página es mayor que la última página, se devolverá una matriz vacía.

Cantidad de cada entidad que se va a obtener por página
page_size integer

Tamaño de cada página que se va a obtener. Al obtener valores, se trata de un tamaño máximo por página, con acceso a las páginas posteriores realizadas por el parámetro page.

Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Devoluciones

Nombre Ruta de acceso Tipo Description
página
meta.page integer

Página de entidades que se han obtenido. La cantidad de entidades de esta página se define mediante page_size.

page_size
meta.page_size integer

Número de entidades que se han obtenido en esta página.

total_items
meta.total_items integer

Número de entidades disponibles en la base de datos, independientemente del tamaño o número de página. Para ver las otras páginas, cambie el número de página de la solicitud.

items
items array of object

Lista de entidades de conversación que se han obtenido de la solicitud de texto.

número_de_teléfono
items.phone_number string

Número de teléfono del contacto

message_id
items.last_message.message_id string

Id. del mensaje. Este valor es único para cada mensaje.

body
items.last_message.body string

Contenido de este mensaje.

message_direction
items.last_message.message_direction string

Carácter singular, ya sea R o S, que indica si este mensaje se recibió del contacto o se les envió, respectivamente.

response_by_username
items.last_message.response_by_username string

Nombre de usuario del usuario solicitud de texto que envió por última vez un mensaje a este usuario.

message_timestamp_utc
items.last_message.message_timestamp_utc string

Marca de tiempo de cuando la solicitud de texto envió o recibió el mensaje.

delivery_status
items.last_message.delivery_status string

Estado actual de este mensaje. Esto puede ser "send", "delivered", "error" o "send".

delivery_error
items.last_message.delivery_error string

Error que provocó que este mensaje no se entregue. Si el delivery_status no es "error", este valor será NULL.

mms_media
items.last_message.mms_media array of string

Lista de direcciones URL que apuntan a los datos adjuntos de este mensaje. Todas las direcciones URL serán direcciones URL generadas por la solicitud de texto.

Obtiene todas las etiquetas.

Obtiene todas las etiquetas de este panel. Las etiquetas son únicas entre paneles.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Página número que se va a obtener
page True integer

Página de entidades que se van a obtener. Al obtener valores, hay un tamaño máximo por página, definido por page_size. Si la página es mayor que la última página, se devolverá una matriz vacía.

Cantidad de cada entidad que se va a obtener por página
page_size True integer

Tamaño de cada página que se va a obtener. Al obtener valores, se trata de un tamaño máximo por página, con acceso a las páginas posteriores realizadas por el parámetro page.

Devoluciones

Nombre Ruta de acceso Tipo Description
página
meta.page integer

Página de entidades que se han obtenido. La cantidad de entidades de esta página se define mediante page_size.

page_size
meta.page_size integer

Número de entidades que se han obtenido en esta página.

total_items
meta.total_items integer

Número de entidades disponibles en la base de datos, independientemente del tamaño o número de página. Para ver las otras páginas, cambie el número de página de la solicitud.

items
items array of object

Lista de entidades de etiqueta que se han obtenido de la solicitud de texto.

id
items.id string

Identificador numérico de la etiqueta.

tag_color
items.tag_color string

Color de la etiqueta. Debe ser un código de color hexadecimal válido.

tag
items.tag string

Nombre de la etiqueta.

Obtiene todos los campos personalizados.

Obtiene todos los campos personalizados de este panel. Los campos personalizados son únicos entre paneles.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
id
id string

Identificador numérico del campo.

nombre
name string

Nombre del campo personalizado.

Obtiene todos los grupos.

Obtiene todos los grupos de la cuenta del usuario.

Parámetros

Nombre Clave Requerido Tipo Description
Página número que se va a obtener
page True integer

Página de entidades que se van a obtener. Al obtener valores, hay un tamaño máximo por página, definido por page_size. Si la página es mayor que la última página, se devolverá una matriz vacía.

Cantidad de cada entidad que se va a obtener por página
page_size True integer

Tamaño de cada página que se va a obtener. Al obtener valores, se trata de un tamaño máximo por página, con acceso a las páginas posteriores realizadas por el parámetro page.

Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Devoluciones

Nombre Ruta de acceso Tipo Description
página
meta.page integer

Página de entidades que se han obtenido. La cantidad de entidades de esta página se define mediante page_size.

page_size
meta.page_size integer

Número de entidades que se han obtenido en esta página.

total_items
meta.total_items integer

Número de entidades disponibles en la base de datos, independientemente del tamaño o número de página. Para ver las otras páginas, cambie el número de página de la solicitud.

items
items array of object

Lista de entidades de grupo que se han obtenido de la solicitud de texto.

id
items.id integer

Identificador numérico del grupo.

group_member_count
items.group_member_count integer

Número de miembros del grupo.

is_keyword
items.is_keyword boolean

Wheter this group is a keyword group. Estos grupos se generan automáticamente cuando un usuario configura una palabra clave. Los contactos se agregan automáticamente cuando se inscriben.

nombre
items.name string

Nombre de este grupo.

notas
items.notes string

Cualquier nota de este grupo.

last_message_sent_utc
items.last_message_sent_utc string

Marca de tiempo de cuándo se envió el último mensaje de grupo para este grupo.

Obtiene todos los pagos

Obtiene todos los pagos, incluidos los pagos cancelados y pagados. Estos se pueden filtrar mediante los parámetros de consulta.

Parámetros

Nombre Clave Requerido Tipo Description
Cadena de referencia del pago
reference_number string

Identificador definido por el usuario cuando se crean pagos que se pueden usar para encontrar rápidamente pagos. Los números de referencia no son únicos; muchos pagos pueden tener la misma referencia.

Número de teléfono de pago
phone_number string

Número de teléfono del contacto al que se envió este pago.

Ordenar por
sort_type string

Propiedad para ordenar pagos por. Puede ser "amount", "contact", "date", "status".

Dirección de ordenación
sort_direction string

Dirección en la que se ordenan los pagos. Puede ser "desc" para mayor a menor o "asc" para menor a mayor.

Página número que se va a obtener
page True integer

Página de entidades que se van a obtener. Al obtener valores, hay un tamaño máximo por página, definido por page_size. Si la página es mayor que la última página, se devolverá una matriz vacía.

Cantidad de cada entidad que se va a obtener por página
page_size True integer

Tamaño de cada página que se va a obtener. Al obtener valores, se trata de un tamaño máximo por página, con acceso a las páginas posteriores realizadas por el parámetro page.

Identificador del panel en el que realizar esta llamada
dashboard_id True integer

Panel de número de teléfono en el que trabajar. Una sola cuenta puede tener varios paneles, que representan diferentes líneas de teléfono para los clientes.

Devoluciones

Nombre Ruta de acceso Tipo Description
página
meta.page integer

Página de entidades que se han obtenido. La cantidad de entidades de esta página se define mediante page_size.

page_size
meta.page_size integer

Número de entidades que se han obtenido en esta página.

total_items
meta.total_items integer

Número de entidades disponibles en la base de datos, independientemente del tamaño o número de página. Para ver las otras páginas, cambie el número de página de la solicitud.

items
items array of object

Lista de entidades de pago que se han obtenido de la solicitud de texto.

payment_id
items.payment_id integer

Identificador numérico del pago.

request_date
items.request_date string

Marca de tiempo de cuándo se puso en cola el mensaje inicial de este pago para enviarse.

destinatario
items.recipient string

Nombre del destinatario del pago. Puede ser null si el contacto no tiene un nombre asociado a su número de teléfono.

descripción
items.description string

Descripción del pago. Esto no se muestra al contacto. Solo lo usan los usuarios internos para el contexto sobre los pagos.

customer_phone
items.customer_phone string

Número de teléfono del contacto que se envía este pago.

amount_requested
items.amount_requested float

Importe en dólares solicitados por este pago.

is_past_due
items.is_past_due boolean

Si este pago ha pasado la fecha de solicitud.

reminder_was_sent
items.reminder_was_sent boolean

Si ya se ha enviado un aviso de texto para este pago.

transaction_status
items.transaction_status string

Estado de la transacción en authvia. Este valor se inicia como Desconocido.

textrequest_payment_status
items.textrequest_payment_status string

Estado de la transacción en Solicitud de texto. Esto representa ese estado que se muestra en la página de pagos de la aplicación Solicitud de texto. Se inicia como Enviado.

reference_number
items.reference_number string

Identificador definido por el usuario cuando se crean pagos que se pueden usar para encontrar rápidamente los pagos. Los números de referencia no son únicos; muchos pagos pueden tener la misma referencia.

Desencadenadores

Desencadena cuando se envía o recibe un texto

Desencadena cuando se envía o recibe un texto

Desencadena cuando se envía o recibe un texto

Desencadena cuando se envía o recibe un texto

Parámetros

Nombre Clave Requerido Tipo Description
El panel del desencadenador escuchará eventos desde
dashboard_id True string

Identificador del panel al que agregar el desencadenador

evento
event True string

evento

Devoluciones

Nombre Ruta de acceso Tipo Description
Id. único del mensaje
messageUniqueIdentifier string

messageUniqueIdentifier

ID de cuenta
account.id integer

id

Id. de conversación
yourPhoneNumber.id integer

id

Nombre del panel
yourPhoneNumber.description string

descripción

Número de teléfono del panel
yourPhoneNumber.phoneNumber string

número de teléfono

Id. del panel
conversation.id integer

id

date
conversation.date string

date

Número de teléfono de contacto
conversation.consumerPhoneNumber string

consumerPhoneNumber

messageDirection
conversation.messageDirection string

messageDirection

Mensaje
conversation.message string

Mensaje

numSegments
conversation.numSegments integer

numSegments

estado
conversation.status string

estado

Conversación reclamada por
conversation.claimedBy string

claimedBy

Nombre para mostrar del contacto
conversation.consumerFriendlyName string

consumerFriendlyName

Definiciones

cuerda / cadena

Este es el tipo de datos básico "string".