Προσθήκη επαφής
Καταχωρίστε ένα άτομο στο βιβλίο επαφών με το χέρι, και χειριστείτε την περίπτωση που υπάρχει ήδη εκεί.
Το create_contact είναι η διαδρομή πληκτρολόγησης προς το βιβλίο επαφών, η ίδια που βρίσκεται πίσω από τη φόρμα «προσθήκη επαφής» του πίνακα ελέγχου: ένα όνομα και ένα email, με τηλέφωνο και εταιρεία ως συνοδευτικά. Το βιβλίο έχει ως κλειδί το email, οπότε η αποστολή ενός που υπάρχει ήδη δεν είναι σφάλμα: επιστρέφει ως κανονική επιτυχία που ονομάζει την επαφή που ήδη έχετε.
Μέθοδος
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.
Οδηγός βήμα προς βήμα
Στείλτε τα τέσσερα πεδία που έχει μια επαφή
Τα name και email είναι τα μόνα δύο που απαιτεί το create_contact. Το source έχει προεπιλογή manual και το context προεπιλογή Added by hand αν τα παραλείψετε, και τα δύο εμφανίζονται στο ιστορικό δραστηριότητας της επαφής.
Η απάντηση
Το existed: true είναι η διαδρομή του διπλότυπου: το email υπήρχε ήδη στο βιβλίο, και το contact_id ονομάζει την επαφή που το είχε ήδη και όχι μια νέα. Διακλαδιστείτε με βάση το existed, όχι το code, για να ξεχωρίσετε τις δύο περιπτώσεις: και οι δύο επιστρέφουν code: 1.
Τα phone και company αποθηκεύονται στην επαφή αλλά δεν επιστρέφονται σε αυτή την απάντηση: διαβάστε τα πίσω με get_contacts ή get_contact_members αν χρειάζεται να επιβεβαιώσετε τι αποθηκεύτηκε.