log_lead_phone

Public Function log_lead_phone(ByVal lead_objid As Long, _
                               ByVal the_text As String, _
                               ByVal iuo As String, _
                               ByVal first As String, _
                               ByVal last As String, _
                               ByVal phone As String, _
                               ByVal action As String, _
                               ByVal log_date As String, _
                               ByVal duration As Long, _
                               ByVal user_name As String, _
                               ByVal gen_time_bombs As Boolean) As Integer

Description

This API allows you to log a phone for a lead. You must specify the objid of the lead (since no other information on the lead is unique), and the description (phone text).  You must also specify a contact for the log. If you want to use the lead as the contact (and not a real contact), then leave the first, last, and phone fields blank, and this will use the lead. You must specify the length of the phone call (in seconds).

There are a variety of optional items that you may set, including the action type of the call, when the call started, and who logged the call.

The API can also generate a time bomb (for business rule notification).

Parameters

Parameter Name	Required?	Description
lead_objid	Yes	The unique object ID of the lead
the_text	No	Note text
iuo	No	Internal Use Only optional text for the phone log
first	Yes	First name of the related contact. If you wish to use the lead as the contact, leave this field blank
last	Yes	Last name of the related contact. If you wish to use the lead as the contact, leave this field blank
phone	Yes	Phone number of the related contact. If you wish to use the lead as the contact, leave this field blank
action	No	Phone Log Action Type. If blank, the default value of the code list is used
log_date	No	When was the call logged? If blank, current date/time used
duration	Yes	How long did the call last, in seconds
user_name	No	Who logged the note? If blank, current user is used
gen_time_bombs	Yes	Should a time bomb be created? Values are "True" or "False".

Returns

Value	Meaning
0	No errors
-1	Cannot find the specified lead
-2	The specified user is not found
-3	The PHONE LOG activity string is not found
-4	Cannot find the specified contact
-5	Cannot locate the specified phone log action type
-6	The duration is < 0

Examples

Sam logged a call on December 12, 2000 (at 11AM) for a lead. The text is "Hello there", and the call lasted 3 minutes and 15 seconds. Do not specify an action type. Use the lead as the contact. Generate time bombs.

JavaScript:

var ret_int = fcsfa.log_lead_phone(268435458, "Hello there", "", "", "", "",
                                   "", "12/12/2000 11:00:00",
                                   195, "sam", true);

Visual Basic:

Dim ret_int As Integer

ret_int = fcsfa.log_lead_phone(268435458, "Hello there", "", "", "", "", _
                               "", "12/12/2000 11:00:00", 195, "sam", True)

Log another call for the same lead. Specify a contact and an action type, and log it at the current time and from the current user. The call lasted 30 seconds, and don't generate a time bomb.

JavaScript:

var ret_int = fcsfa.log_lead_phone(268435458, "More notes", "", "Jane", "Doe",
                             "555-1212", "Outgoing call", "", 30, "", false);

Visual Basic:

Dim ret_int As Integer

ret_int = fcsfa.log_lead_phone(268435458, "More notes", "", "Jane", "Doe", _
                               "555-1212", "Outgoing call", _
                               "", 30, "", False)