Telefacil - Contribuciones del usuario [es]

API de contactos

2025-06-26T11:43:09Z

Dcruz: /* Insertar un contacto */

{{#seo:
|title= Contactos {{PROD_TILDE}}.
|titlemode=append
|keywords=contactos a domicilio, numero virtual, telefono fijo, numero de telefono virtual, API, linea telefonica virtual, segunda linea, apple, sincronizacion, numero fijo en el movil, contactos
|description=Las aplicaciones de los números virtuales pueden sincronizarse con la agenda de contactos de cualquier dispositivo movil y con las APIs.
}}

==¿Qué es?==

===Descripción===

Este servicio web nos permite interactuar con los contactos de una cuenta {{PRODUCTO}}.

Si no sabe lo que es una API lea [[que es una api|¿Qué son las APIs de {{PRODUCTO}}?]]

===Activación===

Este servicio '''debe activarse explícitamente dentro de la web''', en Contactos > API (o en Desarrolladores > Permisos de las APIs y los servicios web). En esa sección también se pueden restringir las direcciones IP desde las que se puede llamar a esta aplicación web. Si usted tiene una dirección IP fija por favor debe introducirla aquí, para aumentar la seguridad.

==Forma de uso==

====Lista de contactos====

Devuelve la lista de contactos (en XML).

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=listar[&eliminados=1&actualizado=1329390208&grupo=Trabajo]

Los usuarios de Canarias deben usar la siguiente URL alternativa:

https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=listar[&eliminados=1&actualizado=1329390208&grupo=Trabajo]

Explicación de los parámetros:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'listar'.

Opcionalmente, se pueden pasar los siguientes parámetros:

* 'actualizado', con una fecha en [https://es.wikipedia.org/wiki/Tiempo_Unix formato UNIX], para que se listen sólo los contactos modificados a partir de dicha fecha. Por ejemplo, actualizado=1329390208.
* 'eliminados', con un valor mayor que 0 (por ejemplo, eliminados=1), para que se listen los contactos eliminados en el último mes. Si eliminados=1, se listan todos los eliminados (en el último mes); si eliminados tiene un valor en [https://es.wikipedia.org/wiki/Tiempo_Unix formato UNIX], se listan los contactos eliminados a partir de esa fecha (por ejemplo, eliminados=1329390208). Si se pasa un valor mayor que 0, la lista de contactos eliminados se añade a la lista de contactos normales. Por defecto, no se muestran los contactos eliminados.
* 'grupo', con el nombre de un grupo de contactos, para que se listen sólo los contactos que pertenecen a dicho grupo (esta condición también afecta a los contactos eliminados).
* 'busqueda', con el contenido de alguno de los campos del contacto, para hacer una búsqueda de los contactos que tienen ese valor.

En vez de enviar el par principal/pass se puede enviar la dupla usuario_voip/password_voip:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?usuario_voip=902955955.1234@{{DOMINIO}}&password_voip=SECRET&accion=listar

Vea un ejemplo de respuesta en [[#Ejemplo de listado de contactos en XML]].

===Lista de contactos MD5===

Cada contacto tiene un código o firma MD5. Dicha firma se genera a partir de sus campos (nombre, apellidos, teléfonos, emails, dirección, etc). Por tanto, si uno de los campos cambia, el MD5 cambia también. Si tenemos almacenados los contactos en una base de datos y queremos ver qué ha cambiado, podemos pedir simplemente los MD5 y comparar con los que tengamos almacenados.

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=listar_md5

Esta llamada se puede usar en conjunción con la siguiente (seleccionar un contacto por su ID) para listar solo los contactos que han cambiado, como alternativa a listar con el parámetro 'actualizado'.

===Lista de grupos de contactos===

Aunque la lista de contactos ya devuelve la lista de grupos, también se puede llamar de esta manera.

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=listar_grupos

Los usuarios de Canarias deben usar la siguiente URL alternativa:

https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=listar_grupos

Los parámetros son iguales que en el caso de listar contactos:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'listar_grupos'.

En vez de enviar el par principal/contraseña se puede enviar la dupla usuario_voip/password_voip:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?usuario_voip=902955955.1234@{{DOMINIO}}&password_voip=SECRET&accion=listar_grupos

===Seleccionar un contacto por su ID===

El listado de contactos nos dice la ID de cada contacto. La ID es un código numérico único que referencia a ese contacto. Si lo necesitamos, podemos seleccionar únicamente los campos de esos contactos con la siguiente URL:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=seleccionar&id=12345

Obviamente, la respuesta será un solo contacto (o ninguno, si la ID es incorrecta).

===Seleccionar un contacto por su número de teléfono===

Devuelve el primero contacto que tenga el número de teléfono pasado por parámetro. Ejemplo de URL:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=seleccionar_por_telefono&telefono=912345678

Obviamente, la respuesta será un solo contacto (o ninguno, si el teléfono no está en un contacto permitido).

===Insertar un contacto===

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=insertar&nombre=Juan&...

donde:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'insertar'.

El resto de campos son opcionales: nombre, apellidos, domicilio, población, cp, provincia, país, organización, puesto y nota.

Para enviar los teléfonos, emails y campos extra, se ha de especificar primero el número de elementos que se están enviando (con num_telefonos, num_emails y num_extras respectivamente) y después mandar los campos numerados desde el 1 hasta el número de elementos.

Por ejemplo, para enviar 3 teléfonos sería:

&num_telefonos=3&telefono1=928999444&tipo_telefono1=0&telefono2=911222333&tipo_telefono2=7&telefono3=666777888&tipo_telefono3=14

Para enviar 1 email y 1 campo extra, sería:

&num_emails=1&email1=micorreo@gmail.com&tipo_email1=0&num_extras=1&nombre_extra1=MiCampoExtra&extra1=MiValor

Vea cómo es cada campo en [[#Tipos de datos]].

También se pueden enviar tipos personalizados ("custom") en los teléfonos y los e-mails, en vez de los tipos enteros prefijados. Para ello, usamos los campos "custom_telefono" y "custom_email" en vez de "tipo_telefono" y "tipo_email". Ejemplo:

&num_telefonos=2&telefono1=928999444&custom_telefono1=MiTipoPropio&telefono2=911222333&tipo_telefono2=0&num_emails=1&email1=micorreo@hotmail.com&custom_email1=MiTipoPropioEmail

Opcionalmente, se puede enviar el campo "listar=1" y, si no hubo error, en la respuesta vendrá el contacto insertado. También opcionalmente se puede mandar un campo "grupo=NOMBRE" (donde NOMBRE es el nombre de un grupo preexistente) y el contacto se asignará a ese grupo nada más ser creado.

===Actualizar un contacto===

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=actualizar&id=123456[&nombre=Pedro&...]

donde:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'actualizar'.
* 'id' es el identificador del contacto.

El resto de campos se envían igual que en el apartado anterior (Insertar un contacto).

Opcionalmente, se puede enviar el campo "listar=1" y, si no hubo error, en la respuesta vendrá el contacto actualizado.

===Eliminar un contacto===

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=eliminar&id=123456

donde:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'eliminar'.
* 'id' es el identificador del contacto.

===Eliminar todos los contactos===

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=eliminar_todo

donde:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'eliminar_todo'.

===Añadir un grupo de contactos===

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=insertar_grupo&grupo=MiGrupo

donde:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'insertar_grupo'.
* 'grupo' es el nombre del nuevo grupo de contactos.

Los grupos deben tener nombres diferentes. Existen 11 grupos predefinidos: Amigos, Asesoría, Clientes, Conocidos, Contabilidad, Familia, Favoritos, General, Oficina, Proveedores y Trabajo.

===Cambiar el nombre de un grupo de contactos===

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=actualizar_nombre_grupo&gid=21&nombre_grupo=NuevoNombreParaElGrupo

donde:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'actualizar_nombre_grupo'.
* 'gid' es la ID del grupo de contactos.
* 'nombre_grupo' es el nuevo nombre del grupo de contactos.

===Eliminar un grupo de contactos===

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=eliminar_grupo&gid=21

donde:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'eliminar_grupo'.
* 'gid' es la ID del grupo de contactos.

No se pueden borrar los grupos predefinidos: Amigos, Asesoria, Clientes, Conocidos, Contabilidad, Familia, Favoritos, General, Oficina, Proveedores y Trabajo.

===Eliminar todos los grupos de contactos===

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=eliminar_todos_grupos

donde:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'eliminar_todos_grupos'.

No se pueden borrar los grupos predefinidos: Amigos, Asesoría, Clientes, Conocidos, Contabilidad, Familia, Favoritos, General, Oficina, Proveedores y Trabajo.

===Asignar un contacto a un grupo de contactos===

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=asignar_grupo&id=123456&grupo=MiGrupo

donde:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'asignar_grupo'.
* 'id' es el identificador del contacto.
* 'grupo' es el nombre del grupo de contactos.

También podemos asignar un contacto a un grupo por su ID de grupo (GID), en vez de por el nombre de grupo. La URL en este caso sería:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxxx&accion=asignar_grupo_id&id=123456&gid=21

donde todo es igual, salvo:

* 'gid' es la ID del grupo de contactos.

===Quitar un contacto de un grupo de contactos===

La URL debe ser:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=quitar_grupo&id=123456grupo=MiGrupo

donde:

* 'principal' es su número de usuario de {{PRODUCTO}}.
* 'pass' es la contraseña de la cuenta.
* 'accion' debe tener el valor 'quitar_grupo'.
* 'id' es el identificador del contacto.
* 'grupo' es el nombre del grupo de contactos.

También podemos quitar un contacto de un grupo por su ID de grupo (GID), en vez de por el nombre de grupo. La URL en este caso sería:

https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?principal=xxxxxxxxx&pass=xxxxxxxx&accion=quitar_grupo_id&id=123456&gid=21

donde todo es igual, salvo:

* 'gid' es la ID del grupo de contactos.

===Gestión de la foto del contacto===

Si el contacto tiene una foto, cuando se liste aparecerá un campo "foto":
<pre>
<foto>
<original>https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=foto&id=1234</original>
<thumbnail_120>https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=foto&id=1234&size=120</thumbnail_120>
<thumbnail_24>https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=foto&id=1234&size=24</thumbnail_24>
</foto>
</pre>
Para bajar dicha foto (nótese que también se ofertan thumbnails a 120x120 y a 24x24) simplemente habrá que usar la URL que se provee añadiéndole los campos "principal" y "pass" (o "usuario_voip" y "password_voip"):

https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=foto&id=1234&principal=999888777&pass=xxxxxxxx

Para subir una nueva foto, usamos 'accion=subir_foto' junto con la 'id' del contacto. Esta petición deberá hacerse como POST multiform/data, con el contenido del fichero en 'fichero':

https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=subir_foto&fichero=...&id=1234&principal=999888777&pass=xxxxxxxx

(Opcionalmente, se puede enviar el campo "listar=1" y, si no hubo error, en la respuesta vendrá el contacto cuya foto se ha actualizado).

Para eliminar una foto de un contacto, usamos 'accion=eliminar_foto' junto con la 'id' del contacto:

https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=eliminar_foto&id=1234&principal=999888777&pass=xxxxxxxx

===Tipos de datos===

Los campos de los contactos son los siguientes:

{| style="width:500px;" border="1"
|-
| '''Campo'''
| '''Tipo'''
| '''Longitud máxima'''
| '''Significado'''
|-
| nombre
| ristra
| 100
| Nombre del contacto
|-
| apellidos
| ristra
| 200
| Apellidos del contacto
|-
| domicilio
| ristra
| 128
| Dirección, número, piso, etc. del contacto
|-
| poblacion
| ristra
| 40
| Población del contacto
|-
| cp
| ristra
| 10
| Código postal del contacto
|-
| provincia
| ristra
| 40
| Provincia del contacto
|-
| pais
| ristra
| 50
| País del contacto
|-
| organizacion
| ristra
| 64
| Organización o empresa del contacto
|-
| puesto
| ristra
| 64
| Puesto que ocupa el contacto en la organización
|-
| email1..emailN
| ristra
| 100
| E-mail del contacto
|-
| telefono1..N
| ristra
| 20
| Números de teléfono
|-
| tipo_telefono1..N
| entero
|
| Tipos de los números de teléfono (ver siguiente tabla)
|-
| extra1..N
| ristra
| 96
| Campos extra para añadir más información sobre el contacto
|-
| nombre_extra1..3
| ristra
| 32
| Nombres de los campos extra
|-
|}

El tipo_telefono es un entero que puede tener los siguientes valores:

{| style="width:200px;" border="1"
|-
| '''Valor'''
| '''Significado'''
|-
| 0
| Tlf. Principal
|-
| 1
| Tlf. Casa
|-
| 2
| Tlf. Oficina
|-
| 3
| Tlf. Trabajo
|-
| 4
| Tlf. Automovil
|-
| 5
| Tlf. Asistente
|-
| 6
| Tlf. Particular
|-
| 7
| Movil Principal
|-
| 8
| Movil Casa
|-
| 9
| Movil Oficina
|-
| 10
| Movil Trabajo
|-
| 11
| Movil Automovil
|-
| 12
| Movil Asistente
|-
| 13
| Movil Particular
|-
| 14
| Fax Principal
|-
| 15
| Fax Casa
|-
| 16
| Fax Oficina
|-
| 17
| Fax Trabajo
|-
| 18
| Fax Automovil
|-
| 19
| Fax Asistente
|-
| 20
| Fax Particular
|-
| 21
| Personalizado/Custom
|-
|}

El tipo_email es un entero que puede tener los siguientes valores:

{| style="width:200px;" border="1"
|-
| '''Valor'''
| '''Significado'''
|-
| 0
| Trabajo
|-
| 1
| Casa
|-
| 2
| Personalizado/Custom
|-
|}

===Respuesta del servicio===

El servicio web retorna todas las respuestas en formato [https://es.wikipedia.org/wiki/Extensible_Markup_Language XML]. Todas las respuestas están encerradas en la raíz 'contactos', y contiene siempre un campo 'error' que será 0 si el comando o petición enviado al servidor se ejecutó con éxito, o 1 si hubo algún error, en cuyo caso habrá también un campo 'msgerr' que explica dicho error.

Por ejemplo, una respuesta afirmativa sería:
<pre>
HTTP/1.1 200 OK
Date: Mon, 20 Feb 2012 11:43:37 GMT
Server: Apache
Keep-Alive: timeout=15, max=100
Connection: Keep-Alive
Transfer-Encoding: chunked
Content-Type: text/xml

<?xml version="1.0" encoding="UTF-8" ?>

<contactos>
<error>0</error>
</contactos>
</pre>
Una respuesta de error sería:
<pre>
HTTP/1.1 200 OK
Date: Mon, 20 Feb 2012 11:43:37 GMT
Server: Apache
Keep-Alive: timeout=15, max=100
Connection: Keep-Alive
Transfer-Encoding: chunked
Content-Type: text/xml

<?xml version="1.0" encoding="UTF-8" ?>

<contactos>
<error>1</error>
<msgerr>Cuenta incorrecta.</msgerr>
</contactos>
</pre>

==Ejemplos==

===Ejemplo de llamada al servicio web en PHP + CURL===

Tenga presente que, aunque la aplicación web es accesible mediante una URL, no debe poner nunca enlaces a esta aplicación directamente en el código fuente de sus páginas web, ya que sus visitantes podrían descubrir datos sensibles como su número de usuario y su contraseña simplemente mirando el código HTML.

La aplicación web debe ser llamada siempre desde el servidor, usando para ello alguna de las librerías que permite llamadas a servicios HTTPS.

He aquí un ejemplo en PHP usando cURL, cortesía de tuayudainformatica.com:
<pre>
<?php
$usuario = '666111666';
$pass = 'MiClaveSecreta1234';

$curl = curl_init("https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apicontactos2?
principal=${usuario}&pass=${pass}&accion=listar"); // LLAMADA DE LA URL
curl_setopt($curl, CURLOPT_HEADER, false); // PARA EVITAR DEVOLUCION DE CABEZERAS HTTP
curl_setopt($curl, CURLOPT_TIMEOUT, 5); // TIEMPO DE ESPERA
$output = curl_exec($curl); // EJECUTAMOS LA LLAMADA
curl_close($curl);
$output = substr($output, 0, 1); // XML
?>
</pre>

===Ejemplo de listado de contactos en XML===

<pre>
<?xml version="1.0" encoding="UTF-8" ?>

<contactos>
<error>0</error>
<num_contactos>7</num_contactos>
<contacto>
<id>124744</id>
<nombre>Ana</nombre>
<apellidos>Rosa</apellidos>
<creado>2011-12-21 00:00:00+01</creado>
<modificado>2011-12-22 11:39:38.594387+01</modificado>
<eliminado>NO</eliminado>
<num_emails>1</num_emails>
<email>
<email>arosa@hotmail.com</email>
<tipo>0</tipo>
</email>
<domicilio></domicilio>
<poblacion></poblacion>
<cp></cp>
<provincia>Alava</provincia>
<pais></pais>
<organizacion></organizacion>
<puesto></puesto>
<nota>Una nota</nota>
<num_telefonos>1</num_telefonos>
<telefono>
<numero>628000001</numero>
<iposicion>1</iposicion>
<tipo>Tfno. Principal</tipo>
</telefono>
<extra>
<nombre>Extra 1:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 2:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 3:</nombre>
<valor></valor>
</extra>
<foto>
<original>https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=foto&id=124744</original>
<thumbnail_120>https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=foto&id=124744&size=120</thumbnail_120>
<thumbnail_24>https://scgi.duocom.es/cgi-bin/telefacil2/apicontactos2?accion=foto&id=124744&size=24</thumbnail_24>
</foto>
<md5>dfa345678abc3344</md5>
<grupos>
<num_grupos>2</num_grupos>
<grupo>Oficina</grupo>
<grupo>TEST GROUP</grupo>
</grupos>
<grupos_id>
<num_grupos>2</num_grupos>
<grupo>
<gid>21</gid>
<gnombre>Oficina</gnombre>
</grupo>
<grupo>
<gid>22</gid>
<gnombre>TEST GROUP</gnombre>
</grupo>
</grupos_id>
</contacto>
<contacto>
<id>34453</id>
<nombre>Fax de pruebas 1</nombre>
<apellidos></apellidos>
<creado>2010-08-09 00:00:00+01</creado>
<modificado>2011-12-22 11:39:38.594387+01</modificado>
<eliminado>NO</eliminado>
<num_emails>0</num_emails>
<domicilio></domicilio>
<poblacion></poblacion>
<cp></cp>
<provincia>Madrid</provincia>
<pais></pais>
<organizacion></organizacion>
<puesto></puesto>
<num_telefonos>1</num_telefonos>
<telefono>
<numero>911011042</numero>
<iposicion>1</iposicion>
<tipo>Movil Principal</tipo>
</telefono>
<extra>
<nombre>Extra 1:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 2:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 3:</nombre>
<valor></valor>
</extra>
<md5>dfa345678abc3345</md5>
<grupos>
<num_grupos>1</num_grupos>
<grupo>Trabajo</grupo>
</grupos>
<grupos_id>
<num_grupos>1</num_grupos>
<grupo>
<gid>23</gid>
<gnombre>Trabajo</gnombre>
</grupo>
</grupos_id>
</contacto>
<contacto>
<id>34454</id>
<nombre>Fax de pruebas 2</nombre>
<apellidos></apellidos>
<creado>2010-08-09 00:00:00+01</creado>
<modificado>2011-12-22 11:39:38.594387+01</modificado>
<eliminado>NO</eliminado>
<num_emails>0</num_emails>
<domicilio></domicilio>
<poblacion></poblacion>
<cp></cp>
<provincia>Madrid</provincia>
<pais></pais>
<organizacion></organizacion>
<puesto></puesto>
<num_telefonos>1</num_telefonos>
<telefono>
<numero>911014571</numero>
<iposicion>1</iposicion>
<tipo>Movil Principal</tipo>
</telefono>
<extra>
<nombre>Extra 1:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 2:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 3:</nombre>
<valor></valor>
</extra>
<md5>dfa345678abc3341</md5>
<grupos>
<num_grupos>0</num_grupos>
</grupos>
<grupos_id>
<num_grupos>0</num_grupos>
</grupos_id>
</contacto>
<contacto>
<id>34455</id>
<nombre>Fax de pruebas 3</nombre>
<apellidos></apellidos>
<creado>2010-08-09 00:00:00+01</creado>
<modificado>2011-12-22 11:39:38.594387+01</modificado>
<eliminado>NO</eliminado>
<num_emails>0</num_emails>
<domicilio></domicilio>
<poblacion></poblacion>
<cp></cp>
<provincia>Las Palmas</provincia>
<pais></pais>
<organizacion></organizacion>
<puesto></puesto>
<num_telefonos>2</num_telefonos>
<telefono>
<numero>928400129</numero>
<iposicion>1</iposicion>
<tipo>Tfno. Principal</tipo>
</telefono>
<telefono>
<numero>928445566</numero>
<iposicion>2</iposicion>
<tipo>Tfno. Casa</tipo>
</telefono>
<extra>
<nombre>Extra 1:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 2:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 3:</nombre>
<valor></valor>
</extra>
<md5>dfa345678abc3333</md5>
<grupos>
<num_grupos>0</num_grupos>
</grupos>
<grupos_id>
<num_grupos>0</num_grupos>
</grupos_id>
</contacto>
<contacto>
<id>57474</id>
<nombre>FILM</nombre>
<apellidos></apellidos>
<creado>2011-06-16 00:00:00+01</creado>
<modificado>2011-12-22 11:39:38.594387+01</modificado>
<eliminado>NO</eliminado>
<num_emails>0</num_emails>
<domicilio></domicilio>
<poblacion></poblacion>
<cp></cp>
<provincia>Madrid</provincia>
<pais></pais>
<organizacion></organizacion>
<puesto></puesto>
<num_telefonos>1</num_telefonos>
<telefono>
<numero>0012127773456</numero>
<iposicion>1</iposicion>
<tipo>Tfno. Principal</tipo>
</telefono>
<extra>
<nombre>Extra 1:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 2:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 3:</nombre>
<valor></valor>
</extra>
<md5>dfa345678abc3123</md5>
<grupos>
<num_grupos>0</num_grupos>
</grupos>
<grupos_id>
<num_grupos>0</num_grupos>
</grupos_id>
</contacto>
<contacto>
<id>132630</id>
<nombre>Oficina</nombre>
<apellidos></apellidos>
<creado>2012-02-06 12:21:08.119168+01</creado>
<modificado>2012-02-06 12:21:08.119168+01</modificado>
<eliminado>NO</eliminado>
<num_emails>0</num_emails>
<domicilio></domicilio>
<poblacion></poblacion>
<cp></cp>
<provincia>Alava</provincia>
<pais></pais>
<organizacion></organizacion>
<puesto></puesto>
<num_telefonos>2</num_telefonos>
<telefono>
<numero>911000111</numero>
<iposicion>1</iposicion>
<tipo>Tfno. Principal</tipo>
</telefono>
<telefono>
<numero>911000112</numero>
<iposicion>2</iposicion>
<tipo>Tfno. Oficina</tipo>
</telefono>
<extra>
<nombre>Extra 1:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 2:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 3:</nombre>
<valor></valor>
</extra>
<md5>dfa345678abc1344</md5>
<grupos>
<num_grupos>0</num_grupos>
</grupos>
<grupos_id>
<num_grupos>0</num_grupos>
</grupos_id>
</contacto>
<contacto>
<id>34456</id>
<nombre>Luis</nombre>
<apellidos>Pino</apellidos>
<creado>2010-08-09 00:00:00+01</creado>
<modificado>2011-12-22 11:39:38.594387+01</modificado>
<eliminado>NO</eliminado>
<num_emails>0</num_emails>
<domicilio></domicilio>
<poblacion></poblacion>
<cp></cp>
<provincia>Las Palmas</provincia>
<pais><![CDATA[España]]></pais>
<organizacion><![CDATA[Duocom Europe, S.L.]]></organizacion>
<puesto></puesto>
<num_telefonos>2</num_telefonos>
<telefono>
<numero>999999999</numero>
<iposicion>1</iposicion>
<tipo>Tfno. Principal</tipo>
</telefono>
<telefono>
<numero>888888888</numero>
<iposicion>2</iposicion>
<tipo>Tfno. Casa</tipo>
</telefono>
<extra>
<nombre>Extra 1:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 2:</nombre>
<valor></valor>
</extra>
<extra>
<nombre>Extra 3:</nombre>
<valor></valor>
</extra>
<md5>dfa345678abc2344</md5>
<grupos>
<num_grupos>3</num_grupos>
<grupo>Trabajo</grupo>
<grupo>Oficina</grupo>
<grupo>Favoritos</grupo>
</grupos>
<grupos_id>
<num_grupos>3</num_grupos>
...
</grupos_id>
</contacto>
<num_contactos_eliminados>1</num_contactos_eliminados>
<contacto>
<id>133230</id>
<nombre>Pedrito</nombre>
<apellidos>Laso</apellidos>
<eliminado>2012-02-17 13:50:26.517797</eliminado>
</contacto>
<grupos>
<num_grupos>15</num_grupos>
<grupo>Amigos</grupo>
<grupo>Asesoria</grupo>
<grupo>CAT 1</grupo>
<grupo>CAT 2</grupo>
<grupo>CAT 3</grupo>
<grupo>CAT 4</grupo>
<grupo>Clientes</grupo>
<grupo>Conocidos</grupo>
<grupo>Contabilidad</grupo>
<grupo>Familia</grupo>
<grupo>Favoritos</grupo>
<grupo>Oficina</grupo>
<grupo>Proveedores</grupo>
<grupo>TEST GROUP</grupo>
<grupo>Trabajo</grupo>
</grupos>
<grupos_id>
<num_grupos>15</num_grupos>
<grupo>
<gid>1</gid>
<gnombre>Amigos</gnombre>
</grupo>
<grupo>
<gid>8</gid>
<gnombre>Asesoria</gnombre>
</grupo>
<grupo>
<gid>21</gid>
<gnombre>CAT 1</gnombre>
</grupo>
<grupo>
<gid>22</gid>
<gnombre>CAT 2</gnombre>
</grupo>
<grupo>
<gid>23</gid>
<gnombre>CAT 3</gnombre>
</grupo>
<grupo>
<gid>41</gid>
<gnombre>CAT 4</gnombre>
</grupo>
<grupo>
<gid>2</gid>
<gnombre>Clientes</gnombre>
</grupo>
<grupo>
<gid>6</gid>
<gnombre>Conocidos</gnombre>
</grupo>
<grupo>
<gid>9</gid>
<gnombre>Contabilidad</gnombre>
</grupo>
<grupo>
<gid>4</gid>
<gnombre>Familia</gnombre>
</grupo>
<grupo>
<gid>10</gid>
<gnombre>Favoritos</gnombre>
</grupo>
<grupo>
<gid>7</gid>
<gnombre>Oficina</gnombre>
</grupo>
<grupo>
<gid>3</gid>
<gnombre>Proveedores</gnombre>
</grupo>
<grupo>
<gid>25</gid>
<gnombre>TEST GROUP</gnombre>
</grupo>
<grupo>
<gid>5</gid>
<gnombre>Trabajo</gnombre>
</grupo>
</grupos_id>
<ult_modificado>2012-02-06 12:21:08.119168+01</ult_modificado>
<ult_eliminado>2012-02-17 13:50:26.517797</ult_eliminado>
</contactos>
</pre>

----

----

'''Indice'''

[[Página principal]] >> [[Desarrolladores]] >> API de contactos.

Trucos de configuración VoIP Duocom

2024-09-13T09:48:57Z

2024-09-03T07:29:47Z

Dcruz:

Archivo:Vtiger 2.png

2024-09-03T07:29:10Z

Dcruz:

Archivo:Retailcrm apikey 1.jpg

2021-08-26T07:05:55Z

Dcruz: Dcruz subió una nueva versión de Archivo:Retailcrm apikey 1.jpg

Simla.com

2021-08-26T06:48:33Z

Dcruz: /* Generar un apiKey para telefonía */

{{#seo:
|title= integración con la centralita virtual de {{PROD_TILDE}}.
|titlemode=append
|keywords=retailcrm
|description=¿Qué es RetailCRM? Le explicamos paso a paso la integración la nuetra centralita virtual con su RetailCRM.
}}
==Generar un apiKey para telefonía==

Tiene que generar una clave para que la telefonía pueda integrarse y operar con su RetailCRM. Los pasos son los siguientes:
[[Archivo:retailcrm_apikey_1.jpg]]

Cree una clave nueva exclusiva para telefonía:
[[Archivo:retailcrm_apikey_2.jpg|alt=Retailcrm api|link=]]

Conceda accesos a los siguientes métodos:
[[Archivo:retailcrm_apikey_3.jpg|alt=Retailcrm api|link=]]
[[Archivo:retailcrm_apikey_4.jpg|alt=Retailcrm api|link=]]

==Proceso de integración==

===Paso 1: Activar integración asociando usuarios a extensiones===

Acceda a [https://www.duocom.es/retailcrm/retail-crm.php | Duocom]

[[Archivo:retailcrm_principal.jpg|alt=Retailcrm|link=]]

Tendrá que especificar APIKey que generó en el apartado anterior, la url de acceso a su RetailCRM y el número de su centralita (si ya es cliente) o cualquier número de contacto. Además si nos especifica su email podremos contactar con usted más fácilmente.

Una vez que haga clic en '''Comenzar integración''', verá todos los empleados de su cuenta, para poder asignarle a cada uno una extensión de su centralita.

[[Archivo:retailcrm_usuarios.png|alt=Retailcrm usuarios|link=]]

Cuando termine de realizar las asignaciones solo tendrá que '''Activar integración''' y la vinculación entre la telefonía quedará hecha.

===Paso 2: Activar disparadores de eventos===

Tendrá que activar algunos disparadores de eventos para que la información de las llamadas se vaya reflejando en Retail CRM.

====Por extensión====

En cada extensión de centralita dentro de su panel de usuario de {{PRODUCTO}} tendrá que ir a Avisos > Avisos avanzados de llamada.

<pre>https://www.duocom.es/cgi-bin/retailcrm_aviso?apikey=XXXXXXXXX&dominio=XXXXXX&llamante=$llamante&llamado=$llamado&ext=XX&tipo=$tipo&referencia=$referencia&duracion=$duracion&fecha=$fecha</pre>

Donde sustituirá:
* '''apikey''' por la generada en el primer paso.
* '''dominio''' será la url de acceso al CRM sin https://
* '''ext''' por la extensión donde lo estemos configurando

[[Archivo:retailcrm_aviso_ext.jpg|alt=Retailcrm aviso|link=]]

====En telefonía - Historial====

Para mantener el historial actualizado tendrá que entrar en Telefonía > Avisos > Avisos avanzados de llamada y poner como url:
<pre>https://www.duocom.es/cgi-bin/retailcrm_aviso_cobrada?apikey=XXXXXXXXX&dominio=XXXXXXX&llamante=$llamante&llamado=$llamado&telefono=$telefono&tipo=$tipo&fecha=$fecha&duracion=$duracion&referencia=$referencia</pre>

Donde sustituirá:
* '''apikey''' por la generada en el primer paso.
* '''dominio''' será la url de acceso al CRM sin https://

[[Archivo:retailcrm_aviso_telefonia_1.jpg|alt=Retailcrm|link=]]

[[Archivo:retailcrm_aviso_telefonia_2.jpg|alt=Retailcrm|link=]]

====En telefonía - Llamadas salientes====

Para que se mantengan al día los eventos de llamadas salientes tiene que rellenar el siguiente webhook con los datos
<pre>https://www.duocom.es/cgi-bin/retailcrm_aviso?apikey=XXXXXXXXX&dominio=XXXXXXX&llamante=$llamante&llamado=$llamado&telefono=$telefono&tipo=$tipo&fecha=$fecha&duracion=$duracion&referencia=$referencia</pre>

Donde sustituirá:
* '''apikey''' por la generada en el primer paso.
* '''dominio''' será la url de acceso al CRM sin https://

[[Archivo:retailcrm_aviso_telefonia_3.jpg|alt=Retailcrm|link=]]

===Paso 3: Completar integración con nuestro personal===

Uno de nuestros técnicos se pondrá en contacto con usted para completar la integración y ayudarle a configurar su centralita virtual.

==¿Cómo hacer llamadas desde RetailCRM?==

En primer lugar tendrá que tener configurada su extensión para llamar, bien sea en un telefono IP tipo Cisco o en nuestro Voip Duocom, que puede descargar en su área personal > Oficina Virtual > Descargas.

Una vez que la integración esté hecha, verá un icono de teléfono al lado de cada número. Si hace click hará la llamada al número.

[[Archivo:retailcrm_hacerllamada.jpg|alt=Retailcrm|link=]]

==¿Cómo recibir llamadas?==

Cuando reciba una llamada en su extensión de centralita verá un popup con los datos del llamante. Si el número pertenece a un cliente que tiene almacenado en RetailCRM podrá ver los datos del mismo y acceder a su ficha.

[[Archivo:retailcrm_llamada_entrante.jpg|alt=Retailcrm|link=]]

==Historial de llamadas en el CRM==

Cuando una llamada entrante o saliente finaliza, sus datos quedarán registrados en el CRM. De esta forma podrá ver para cada cliente, todas las llamadas que han intercambiado, con los datos de las mismas y las grabaciones si las tiene contratadas.

[[Archivo:retailcrm_historial_llamada.jpg|alt=Retailcrm|link=]]

Monday.com

2021-04-29T14:43:19Z

Dcruz: /* ¿Qué necesita? */

Si usted utiliza Monday.com puede disponer de las llamadas de su centralita utilizando nuestros webhooks y con la API de Monday

==¿Qué necesita?==

Solo necesita obtener el '''token''' para utilizar la API y un '''programa''' intermedio que realice las acciones necesarios cuando llega una llamada, se cuelga o se realiza.

[https://monday.com/developers/v2#authentication-section-accessing-tokens Aquí tiene la información de cómo obtener]

[[Archivo:token_monday.png]]

==Ejemplo práctico==

Vamos crear un item por cada llamada entrante a la extensión 1 (Técnicos) en el tablero consultas técnicas.

===Programamos un webhook cuando una llamada se cuelga o es perdida en la extensión 1===

Nos iremos a la extensión 1 > Avisos y podremos algo similar a esto:

https://www.miservidor.es/monday_llamada.php?llamante=$llamante&llamado=$llamado&tipo=$tipo&referencia=$referencia&duracion=$duracion&fecha=$fecha

[[Archivo:webhook_monday.png]]

===Código del servidor===

<?php
//cogemos los datos de la llamada que nos vienen del webhook
$llamante=$_GET["llamante"];
$tipo=$_GET["tipo"];
$duracion=$_GET["duracion"];
$fecha=$_GET["fecha"];

//este token es un identificador que se genera en el propio monday
$token ="XXXXXXXXXXXXX";
//identificador del tablero donde vamos a meter el item (se puede obtener programaticamente con la API de monday.com
$boardid1="1226936037";

//creamos la petición a la API de monday.com
$ch = curl_init("https://api.monday.com/v2");
//metemos el token de autorización en la cabecera
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: $token","Content-Type:application/json"));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

//formamos el json con los datos del webhook
$titulo = "Llamada del ".$llamante;
//adaptamos la fecha al formato de monday.com, el webhook nos la da así 20210429142052
$solohora = solohora($fecha); //nos devolverá 14:20:25
$solofecha = solofecha($fecha); //nos devolverá 2021-04-29
$fechaprep = "{\\\"date4\\\":{\\\"date\\\":\\\"$solofecha\\\",\\\"time\\\":\\\"$solohora\\\"}";

//como ejemplo si la llamada es perdida ponemos un estado y si fue contestada otro
if ($tipo == "llamada_perdida")
$estado = "\\\"status\\\": {\\\"label\\\": \\\"Stuck\\\"}}";
else
$estado = "\\\"status\\\": {\\\"label\\\": \\\"Done\\\"}}";

$accion = "mutation {create_item (board_id:$boardid1, item_name:\"$titulo\", column_values:\"$fechaprep,$estado\"){id}}";
$data = array(
"query" => $accion
);
$json = json_encode($data);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
$salida = curl_exec($ch);
curl_close($ch);
?>

Puede descargar el código de ejemplo [http://www.duocom.es/pub/monday_llamada.txt aquí]

===Resultado===

[[Archivo:monday_items_creados.png]]

Monday.com

2021-04-29T14:42:59Z

Dcruz: /* Programamos un webhook cuando una llamada se cuelga o es perdida en la extensión 2 */

Si usted utiliza Monday.com puede disponer de las llamadas de su centralita utilizando nuestros webhooks y con la API de Monday

==¿Qué necesita?==

Solo necesita obtener el token para utilizar la API y un programa intermedio que realice las acciones necesarios cuando llega una llamada, se cuelga o se realiza.

[https://monday.com/developers/v2#authentication-section-accessing-tokens Aquí tiene la información de cómo obtener]

[[Archivo:token_monday.png]]

==Ejemplo práctico==

Vamos crear un item por cada llamada entrante a la extensión 1 (Técnicos) en el tablero consultas técnicas.

===Programamos un webhook cuando una llamada se cuelga o es perdida en la extensión 1===

Nos iremos a la extensión 1 > Avisos y podremos algo similar a esto:

https://www.miservidor.es/monday_llamada.php?llamante=$llamante&llamado=$llamado&tipo=$tipo&referencia=$referencia&duracion=$duracion&fecha=$fecha

[[Archivo:webhook_monday.png]]

===Código del servidor===

<?php
//cogemos los datos de la llamada que nos vienen del webhook
$llamante=$_GET["llamante"];
$tipo=$_GET["tipo"];
$duracion=$_GET["duracion"];
$fecha=$_GET["fecha"];

//este token es un identificador que se genera en el propio monday
$token ="XXXXXXXXXXXXX";
//identificador del tablero donde vamos a meter el item (se puede obtener programaticamente con la API de monday.com
$boardid1="1226936037";

//creamos la petición a la API de monday.com
$ch = curl_init("https://api.monday.com/v2");
//metemos el token de autorización en la cabecera
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: $token","Content-Type:application/json"));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

//formamos el json con los datos del webhook
$titulo = "Llamada del ".$llamante;
//adaptamos la fecha al formato de monday.com, el webhook nos la da así 20210429142052
$solohora = solohora($fecha); //nos devolverá 14:20:25
$solofecha = solofecha($fecha); //nos devolverá 2021-04-29
$fechaprep = "{\\\"date4\\\":{\\\"date\\\":\\\"$solofecha\\\",\\\"time\\\":\\\"$solohora\\\"}";

//como ejemplo si la llamada es perdida ponemos un estado y si fue contestada otro
if ($tipo == "llamada_perdida")
$estado = "\\\"status\\\": {\\\"label\\\": \\\"Stuck\\\"}}";
else
$estado = "\\\"status\\\": {\\\"label\\\": \\\"Done\\\"}}";

$accion = "mutation {create_item (board_id:$boardid1, item_name:\"$titulo\", column_values:\"$fechaprep,$estado\"){id}}";
$data = array(
"query" => $accion
);
$json = json_encode($data);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
$salida = curl_exec($ch);
curl_close($ch);
?>

Puede descargar el código de ejemplo [http://www.duocom.es/pub/monday_llamada.txt aquí]

===Resultado===

[[Archivo:monday_items_creados.png]]

2021-04-29T14:07:52Z

Dcruz: /* ¿Qué necesita? */

Si usted utiliza Monday.com puede disponer de las llamadas de su centralita utilizando nuestros webhooks y con la API de Monday

==¿Qué necesita?==

Solo necesita obtener el token para utilizar la API y un programa intermedio que realice las acciones necesarios cuando llega una llamada, se cuelga o se realiza.

[https://monday.com/developers/v2#authentication-section-accessing-tokens Aquí tiene la información de cómo obtener]

[[Archivo:token_monday.png]]

==Ejemplo práctico==

Vamos crear un item por cada llamada entrante a la extensión 1 (Técnicos) en el tablero consultas técnicas.

===Programamos un webhook cuando una llamada se cuelga o es perdida en la extensión 2===

Nos iremos a la extensión 1 > Avisos y podremos algo similar a esto:

https://www.miservidor.es/monday_llamada.php?llamante=$llamante&llamado=$llamado&tipo=$tipo&referencia=$referencia&duracion=$duracion&fecha=$fecha

[[Archivo:webhook_monday.png]]

===Código del servidor===

<?php
//cogemos los datos de la llamada que nos vienen del webhook
$llamante=$_GET["llamante"];
$tipo=$_GET["tipo"];
$duracion=$_GET["duracion"];
$fecha=$_GET["fecha"];

//este token es un identificador que se genera en el propio monday
$token ="XXXXXXXXXXXXX";
//identificador del tablero donde vamos a meter el item (se puede obtener programaticamente con la API de monday.com
$boardid1="1226936037";

//creamos la petición a la API de monday.com
$ch = curl_init("https://api.monday.com/v2");
//metemos el token de autorización en la cabecera
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: $token","Content-Type:application/json"));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

//formamos el json con los datos del webhook
$titulo = "Llamada del ".$llamante;
//adaptamos la fecha al formato de monday.com, el webhook nos la da así 20210429142052
$solohora = solohora($fecha); //nos devolverá 14:20:25
$solofecha = solofecha($fecha); //nos devolverá 2021-04-29
$fechaprep = "{\\\"date4\\\":{\\\"date\\\":\\\"$solofecha\\\",\\\"time\\\":\\\"$solohora\\\"}";

//como ejemplo si la llamada es perdida ponemos un estado y si fue contestada otro
if ($tipo == "llamada_perdida")
$estado = "\\\"status\\\": {\\\"label\\\": \\\"Stuck\\\"}}";
else
$estado = "\\\"status\\\": {\\\"label\\\": \\\"Done\\\"}}";

$accion = "mutation {create_item (board_id:$boardid1, item_name:\"$titulo\", column_values:\"$fechaprep,$estado\"){id}}";
$data = array(
"query" => $accion
);
$json = json_encode($data);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json);
$salida = curl_exec($ch);
curl_close($ch);
?>

===Resultado===