API de gestión de contactos

Gestione los grupos y contactos de cuentas de Afilnet desde nuestra API. Cree, edito o modifique información de grupos o contactos desde su propio software.

  • API HTTP, Gestione grupos y contactos desde cualquier lenguaje de programación
  • 99.9% SLA, Optimizamos el rendimiento de todos los servidores.
SMS API

Lenguajes de programación

Pulse en el lenguaje de programación que desee y acceda a ejemplos para integrar la API de Contactos con sólo copiar y pegar

Funcionalidad de la API

Crear grupo

Método de la API que le permite crear un grupo de contactos en Afilnet. Los grupos de contactos pueden ser utilizados para gestionar envíos automatizados o para realizar campañas a través de SMS, voz o email.
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=creategroup Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
name Nombre del grupo Obligatorio
type Tipo de grupo (email o mobile) Obligatorio
fields Listado de campos separados por comas, obligatorio incluir un campo movil si tipo = mobile y un campo email si tipo = email Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
INCORRECT_TYPE Tipo incorrecto, debe ser mobile o email
MISSING_MAIN_FIELD Falta el campo principal (mobile si tipo = mobile o email si tipo = email)

Parámetros:

  • class : group
  • method : creategroup
  • user : user
  • password : password
  • name : test name
  • type : mobile
  • fields : mobile,name,address

Petición:

https://www.afilnet.com/api/http/?class=group&method=creategroup&user=user&password=password&name=test name&type=mobile&fields=mobile,name,address

Obtener campos de un grupo

Método de la API que le permite obtener un listado de todos los campos de un grupo. Estos campos le permitirán personalizar sus mensajes (SMS, voz, email,...).
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=getgroupcolumns Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup Identificador del grupo Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado

Parámetros:

  • class : group
  • method : getgroupcolumns
  • user : user
  • password : password
  • idgroup : 1000

Petición:

https://www.afilnet.com/api/http/?class=group&method=getgroupcolumns&user=user&password=password&idgroup=1000

Añadir campo a un grupo

Método de la API que le permite añadir un nuevo campo a su grupo de contactos. Cada campo es un dato adicional que guarda sobre los contactos del grupo (nombre, apellidos, direccion, referencia, etc.)
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=addcolumntogroup Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup Identificador del grupo Obligatorio
field Campo del grupo Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado

Parámetros:

  • class : group
  • method : addcolumntogroup
  • user : user
  • password : password
  • idgroup : 1000
  • field : name

Petición:

https://www.afilnet.com/api/http/?class=group&method=addcolumntogroup&user=user&password=password&idgroup=1000&field=name

Elimina campo de un grupo

Método de la API que le permite eliminar un campo existente de su grupo de contactos.
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=deletecolumnfromgroup Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup Identificador del grupo Obligatorio
field Campo del grupo Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado

Parámetros:

  • class : group
  • method : deletecolumnfromgroup
  • user : user
  • password : password
  • idgroup : 1000
  • field : name

Petición:

https://www.afilnet.com/api/http/?class=group&method=deletecolumnfromgroup&user=user&password=password&idgroup=1000&field=name

Eliminar un grupo de contactos

Método de la API que le permite eliminar un grupo de contactos.
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=deletegroup Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup Identificador del grupo Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado

Parámetros:

  • class : group
  • method : deletegroup
  • user : user
  • password : password
  • idgroup : 1000

Petición:

https://www.afilnet.com/api/http/?class=group&method=deletegroup&user=user&password=password&idgroup=1000

Asigna país a un grupo

Método de la API que le permite asignar un país a un grupo de contactos. Esto es obligatorio para crear eventos asociados al grupo.
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=assigncountrytogroup Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup Identificador del grupo Obligatorio
countryiso3 Código ISO del país Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado
COUNTRY_NOT_FOUND No existe ningún país con el código indicado

Parámetros:

  • class : group
  • method : assigncountrytogroup
  • user : user
  • password : password
  • idgroup : 1000
  • countryiso3 : esp

Petición:

https://www.afilnet.com/api/http/?class=group&method=assigncountrytogroup&user=user&password=password&idgroup=1000&countryiso3=esp

Obtener contactos del grupo

Método de la API que le permite obtener todos los contactos asociados a un grupo.
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=getcontacts Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup Identificador del grupo Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado

Parámetros:

  • class : group
  • method : getcontacts
  • user : user
  • password : password
  • idgroup : 1000

Petición:

https://www.afilnet.com/api/http/?class=group&method=getcontacts&user=user&password=password&idgroup=1000

Obtener un contacto de un grupo

Método de la API que le devuelve un contacto de un grupo.
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=getcontact Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup ID del grupo Obligatorio
idcontact ID del contacto Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado
NOT_ACCESS_TO_CONTACT ERROR_NOT_ACCESS_TO_CONTACT

Parámetros:

  • class : group
  • method : getcontact
  • user : user
  • password : password
  • idgroup : 1000
  • idcontact : 1000

Petición:

https://www.afilnet.com/api/http/?class=group&method=getcontact&user=user&password=password&idgroup=1000&idcontact=1000

Añadir contacto a grupo

Método de la API que le permite añadir un nuevo contacto a un grupo. El contacto a añadir debe tener asignados todos los campos registrados en el grupo.
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=addcontact Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup Identificador del grupo Obligatorio
contact Contacto a añadir con los campos separados por comas, ver ejemplo Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
CONTACT_EXISTS Contacto ya existe en el grupo
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado

Parámetros:

  • class : group
  • method : addcontact
  • user : user
  • password : password
  • idgroup : 1000
  • contact : mobile:123456789,name:testname

Petición:

https://www.afilnet.com/api/http/?class=group&method=addcontact&user=user&password=password&idgroup=1000&contact=mobile:123456789,name:testname

Añade una lista de contactos a un grupo

Método de la API que agrega una lista de contactos a un grupo.
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=addcontactlist Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup ID del grupo Obligatorio
contacts Lista de contactos en formato JSON Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado

Parámetros:

  • class : group
  • method : addcontactlist
  • user : user
  • password : password
  • idgroup : 1000
  • contacts : [{"name":"Test","mobile":"34600000000"},{"name":"Test","mobile":"34600000001"}]

Petición:

https://www.afilnet.com/api/http/?class=group&method=addcontactlist&user=user&password=password&idgroup=1000&contacts=[{"name":"Test","mobile":"34600000000"},{"name":"Test","mobile":"34600000001"}]

Modificar contacto del grupo

Método de la API que le permite modificar un contacto de un grupo. El contacto debe tener asignados todos los campos registrados en el grupo.
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=modifycontact Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup Identificador del grupo Obligatorio
idcontact Identificador del contacto Obligatorio
contact Contacto a añadir con los campos separados por comas, ver ejemplo Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado

Parámetros:

  • class : group
  • method : modifycontact
  • user : user
  • password : password
  • idgroup : 1000
  • idcontact : 1000
  • contact : mobile:123456789,name:testname

Petición:

https://www.afilnet.com/api/http/?class=group&method=modifycontact&user=user&password=password&idgroup=1000&idcontact=1000&contact=mobile:123456789,name:testname

Eliminar contacto del grupo

Método de la API que le permite eliminar un contacto de un grupo.
Parámetro Descripción Obligatorio / Opcional
class=group Clase a la que se realiza la petición Obligatorio
method=deletecontact Método de la clase al que se realiza la petición Obligatorio
user El usuario / email de su cuenta de Afilnet Obligatorio
password El password de su cuenta de Afilnet Obligatorio
idgroup Identificador del grupo Obligatorio
idcontact Identificador del contacto Obligatorio

Respuesta:

  • status
  • result (si status=success), recibirá los siguientes valores:
    • No recibirá valores adicionales
  • error (si status=error), aquí recibirá el código de error

Códigos de error:

Código Descripción
MISSING_USER Usuario / email no incluido
MISSING_PASSWORD Password no incluido
MISSING_CLASS Clase no incluida
MISSING_METHOD Método no incluido
MISSING_COMPULSORY_PARAM Parámetro obligatorio no incluido
INCORRECT_USER_PASSWORD Usuario o clave incorrectos
INCORRECT_CLASS Clase incorrecta
INCORRECT_METHOD Método incorrecto
NOT_ACCESS_TO_GROUP No dispone de permisos al grupo indicado

Parámetros:

  • class : group
  • method : deletecontact
  • user : user
  • password : password
  • idgroup : 1000
  • idcontact : 1000

Petición:

https://www.afilnet.com/api/http/?class=group&method=deletecontact&user=user&password=password&idgroup=1000&idcontact=1000

Herramientas que potencian nuestra API de gestión de contactos

CONEXIÓN CON API DE FORMA SEGURA

CONEXIÓN CON API DE FORMA SEGURA

Seguridad adaptada a su empresa

Configure sus conexiones por API, cree nuevos accesos y administre los existentes.

Filtre por IP todos los accesos a la API, añada o elimine IPs habilitadas para garantizar la seguridad de sus accesos.

Lleve un control de todas las conexiones realizadas, la API utilizada y las fechas / hora de conexión

MULTIPLES APIs

MULTIPLES APIs

Conectividad adaptada a su empresa

Le ofrecemos multiples APIs para conectar con nosotros, disponemos de una API HTTP, BASIC AUTH, SOAP y Autenticación JWT para que conecte con nosotros de la forma que desee.

Conecte con cualquiera de las APIs de forma segura, sencilla y centralizada. Afilnet API es perfecta para su software.

API Logs

API Logs

Conozca cada petición al detalle

Gracias a nuestros logs podrá revisar todas las peticiones realizadas y la correspondiente respuesta de nuestra API, lo que le permitirá consultar detalles cuando le necesite.

La información que puede consultar es la siguiente:

  • IP origen de la petición
  • Fecha & Hora de la petición
  • API & Método al que se llama
  • Parámetros enviados a la API
  • Respuesta de la API
  • Metadatos

Pasos para usar la API de Contactos

Utilizar la API de gestión de contactos sólo le llevará unos minutos

01

Solicite su prueba gratuita

Para acceder a la API de contactos deberá estar registrado cómo cliente de Afilnet. Regístrese en sólo unos minutos.

02

Integre la API de contactos

Relice la integración de la API de contactos con el lenguaje de programación que desee. Utilice nuestros ejemplos para una integración rápida y contacte con nuestro equipo si tiene dudas.

03

Utilice de forma ilimitada

Haga uso de la API de contactos cómo desee. Esta API no tiene ninguna limitación, gestione sus grupos de contactos cómo desee.

04

¡Bienvenido a Afilnet!

¡Todo listo!, ha conseguido mejorar sus comunicaciones con Afilnet. Estamos para darle soporte de nuestra API cuando lo necesite

¡Pruebe Afilnet gratis!

¡Registrese gratis y pruebe Afilnet! Le ofrecemos una prueba gratuita de nuestros servicios. *



(*) Promoción sólo válida para empresas que nunca han utilizado el servicio de Afilnet con anterioridad. Al solicitar el saldo gratuito es posible que Afilnet solicite verificar la información de su empresa


SMS Masivo · Email Marketing · Redes Sociales · Mensajería Instantánea · Certificación · y mucho más
Continuar INFORMACIÓN IMPORTANTE SOBRE COOKIES: Este sitio web utiliza cookies propias para ofrecer un mejor servicio. Si continúa navegando consideramos que acepta su uso. Encontrará más información en nuestra Política de Cookies.
Métodos de pago
Transferencia Bancaria
Tarjeta de Crédito
Paypal
Western Union
Skrill
Crypto
Afilnet en su idioma

Copyright © 2024 Afilnet · Todos los derechos Reservados