Saltar para o conteúdo
Verificado

Adicionar um contacto

Registe uma pessoa na lista de contactos manualmente e trate o caso de ela já lá estar.

create_contact é o caminho de entrada manual para a lista de contactos, o mesmo que está por trás do próprio formulário "Adicionar contacto" do painel: um nome e um e-mail, com telefone e empresa como extras. A lista é indexada por e-mail, por isso enviar um que já existe não é um erro, regressa como um sucesso normal que indica o contacto que já tem.

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.

Passo a passo

Envie os quatro campos que um contacto tem

name e email são os únicos dois que create_contact exige. source tem por omissão manual e context tem Added by hand se os deixar de fora, ambos são mostrados no próprio histórico de atividade do 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'])

A resposta

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

existed: true é o caminho do duplicado: o e-mail já estava na lista e contact_id indica o contacto que já o tinha em vez de um novo. Ramifique por existed, não por code, para distinguir os dois casos, ambos regressam com code: 1.

phone e company ficam guardados no contacto mas não são devolvidos nesta resposta; leia-os com get_contacts ou get_contact_members se precisar de confirmar o que foi guardado.

Erros

A seguir