Adaugă un contact
Introdu o persoană în agenda de contacte manual și tratează cazul în care există deja în ea.
create_contact este calea tastată manual spre agenda de contacte, aceeași din spatele
formularului „adaugă contact” din tabloul de bord: un nume și un e-mail, cu telefon și companie ca
adaos. Agenda este indexată după e-mail, așa că trimiterea unuia care există deja nu este o eroare,
revine ca un succes obișnuit care numește contactul pe care îl ai deja.
Metodă
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.
Parcurgere
Trimite cele patru câmpuri pe care le are un contact
name și email sunt singurele două pe care le cere create_contact. source este implicit
manual, iar context este implicit Added by hand dacă le omiți, ambele apar în istoricul de
activitate al contactului.
Răspunsul
existed: true este calea duplicatului: e-mailul era deja în agendă, iar contact_id numește
contactul care îl avea deja, nu unul nou. Ramifică după existed, nu după code, ca să deosebești
cele două cazuri, ambele revin cu code: 1.
phone și company sunt stocate pe contact, dar nu sunt returnate în acest răspuns; citește-le
înapoi cu get_contacts sau get_contact_members dacă vrei să confirmi ce s-a salvat.