Saltar al contenido
Verificada

Añadir un contacto

Guarda a una persona en la agenda de contactos a mano y gestiona el caso en que ya esté en ella.

create_contact es la vía de entrada manual a la agenda de contactos, la misma que usa el formulario "añadir contacto" del propio dashboard: un nombre y un correo, con teléfono y empresa como extra. La agenda se identifica por correo, así que enviar uno que ya existe no es un error: vuelve como un éxito normal con el nombre del contacto que ya tienes.

Método

POST/cpi/create_contact
user

Create Contact

Adds a person to the contact book by hand, from typed details rather than from a received message. Takes only the fields a contact has, name, email, phone, company, job title and its kind (personal or business, which then needs no model to classify it), and ignores anything else the caller happens to hold, such as a shipping address. The email is the book's key, so it is required and a repeat of one already filed returns the existing contact instead of a second copy.

Paso a paso

Envía los cuatro campos de un contacto

name y email son los únicos que create_contact exige. source toma por defecto manual y context toma Added by hand si los omites; ambos se muestran en el historial de actividad del propio contacto.

curl -s https://xuda.ai/cpi/create_contact \
  -H 'content-type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "name": "Priya Shah",
    "email": "[email protected]",
    "phone": "+1 555 0110",
    "company": "Northwind"
  }'
const res = await fetch('https://xuda.ai/cpi/create_contact', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    name: 'Priya Shah',
    email: '[email protected]',
    phone: '+1 555 0110',
    company: 'Northwind',
  }),
});
const { code, data } = await res.json();
if (code > 0 && data.existed) console.log('already in the book:', data.contact_id);
else if (code > 0) console.log('created:', data.contact_id);
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_contact',
    json={
        'api_key': 'YOUR_API_KEY',
        'name': 'Priya Shah',
        'email': '[email protected]',
        'phone': '+1 555 0110',
        'company': 'Northwind',
    },
)
body = res.json()
if body['code'] > 0 and body['data']['existed']:
    print('already in the book:', body['data']['contact_id'])
elif body['code'] > 0:
    print('created:', body['data']['contact_id'])

La respuesta

json
{
  "code": 1,
  "data": {
    "contact_id": "cnt_a91f0e",
    "name": "Priya Shah",
    "email": "[email protected]",
    "existed": false
  }
}

existed: true es el caso del duplicado: el correo ya estaba en la agenda y contact_id indica el contacto que ya lo tenía, no uno nuevo. Ramifica según existed, no según code, para distinguir los dos casos; ambos vuelven con code: 1.

phone y company se guardan en el contacto pero no se repiten en esta respuesta; léelos con get_contacts o get_contact_members si necesitas confirmar lo que se guardó.

Errores

Siguiente