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
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.
A resposta
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.