Creating a contact or lead in Sell for a caller

The telephony system can create a contact or lead in Zendesk Sell using only a caller's phone number. For example, the system can create a contact or lead for a caller after searching for the caller in Sell and not finding them.

Use theCreate a Contactendpoint in the Zendesk Sell API to create a contact in Sell. Or use theCreate a Leadendpoint to create a lead. Note that you use a truncated path for the URL:

POST /v2/contacts.json

POST /v2/leads.json

The endpoint expects a JSON object named数据. For example:

             

              
{"data":{"name":"Mark Johnson","first_name":"Mark","last_name":"Johnson","title":"CEO","phone":"508-778-6516"...},"tags":["contractor","early-adopter"],"custom_fields":{"referral_website":"http://www.example.com"}}}
             

The phone property should comply with the E.164 international telephone numbering plan. For example: "+15551234567". E164 numbers are international numbers with a country dial prefix, usually an area code and a subscriber number. A valid E.164 phone number must include a country calling code.

For new leads, thelast_nameproperty is required for individuals andorganization_namefor an organization. For new contacts,first_nameandlast_nameis required for individuals, andnamefor organizations. You can supply a temporary name such as "Caller: 15551234567". The agent can then get more information from the user when on the call, such as their name and email address.

For details about the JSON object, seeContactsandLeadsin the Sell developer docs.