Скорее всего, вы и ваша команда ощущались в какой-то момент, потому что вы пропускаете продажи, которые вы могли бы сделать, если данные лучше использовались. Вы приняли усилия по реализации Pipedrive в качестве продаж CRM, но какая-то другая система также генерирует ценные данные, которые также не кормят Pipedrive.
Кроме того, точка данных аккуратно не соответствует полям по умолчанию Pipedrive. Например, существует, например, поле по умолчанию для даты окончания пробной конечной сети для включения в ваших контактных записях (даже если это может помочь вам добраться до потенциальных клиентов в вашем трубопроводе продаж с предложением в нужное время). К счастью, вы можете создать пользовательское поле и записать данные для него, используя API Pipedrive, и значительно улучшит функциональность процесса продаж.
Установка с API Pipdrive
Мы будем использовать Python, чтобы подключиться к API Pipedrive, чтобы сделать данные даты пробной версии пробной даты, где нам нужно, чтобы она была. Для подключения к API Pipedrive вам нужно будет собрать две вещи из веб-приложения. Во-первых, вам понадобится ваш токен доступа API, который вы можете найти здесь Отказ Если у вас есть доступ к нескольким компаниям, убедитесь, что вы находитесь в правильной среде. Во-вторых, вам понадобится домен компании, который вы можете найти в адресной строке (например, https://this-is-your-domain.pipedrive.com .)
Вам также придется установить Python запросы библиотеки Если вы еще не сделали это ранее. Вы можете сделать это, запустив свой терминал или командную строку и введя команду ниже.
pip install requests pip3 install requests # Use this if the first one doesn't work for you.
Мы рекомендуем запустить весь код в Jupyter ноутбук Для вашей первой попытки, чтобы вы могли легко увидеть вывод и взаимодействовать с ним, хотя создание файла .py также будет работать.
Мы начнем, импортируя необходимые библиотеки. Библиотека запросов позволит нам сделать HTTP-запросы на API Pipedrive и JSON Библиотека позволит нам должным образом разобрать ответы.
import json import requests
Проверка ваших существующих полей Pipdrive
Прежде чем начать, нам нужно выяснить, если поле мы хотим написать данные для уже существующих. Поскольку мы будем делать запрос на получение, почтовый запрос и запрос на поставку, переменные были предложены Получить_ , post_ и поставить_ чтобы помочь вам различать их.
# token hasn't been prepended with get_ because it needs to be sent with all requests.
token = {
'api_token': 'your-api-token-found-in-the-web-app'
}
get_url = 'https://your-domain.pipedrive.com/api/v1/personFields'
# The params argument is appended to the url as a query parameter.
get_response = requests.get(get_url, params=token)
get_content = json.loads(get_response.content)
# Upon success, the key 'success' will equal True.
print(get_content['success'])
Ответ на успешный запрос GET будет содержать поля, которые у вас уже есть в ключевых данных API. Мы распечатаем имена всех полей и их соответствующих индексов. Если у вас есть конвенции о том, что ваша компания по именованию не является абсолютно Topnotch, вы захотите пройти этот список вручную, чтобы проверить, существует ли ваша собственная поля.
get_data = get_content['data']
for i, v in enumerate(get_data):
print(i, v['name'])
# If you want to further examine the field at index 5.
print(get_data[5])
Если пользовательское поле, которое вы хотите написать, чтобы уже существует, сохраните его «ключ» значение для переменной.
# If for example the index of your field is 5. field_key = get_data[5]['key']
Следуйте вместе с следующим разделе, чтобы создать пользовательское поле, если вы не нашли существующее поле, которое соответствует вашим потребностям.
Создание пользовательского поля Pipedrive
Создание пользовательского поля, если оно не существует, это довольно просто просто. Вам просто нужно будет думать о имени для вашего пользовательского поля и решить его тип. У вас есть несколько вариантов, когда дело доходит до типа поля, который вы можете найти в API Ссылка Отказ Для нашей пробной даты окончания даты, это имеет наибольшее значение для «даты».
# token should still be defined from the GET request, but in case you skipped over that, here it is again.
token = {
'api_token': 'your-api-token-found-in-the-web-app'
}
# The field that you want to create.
post_data = {
'name': 'trial end date',
'field_type': 'date'
}
post_url = 'https://your-domain.pipedrive.com/api/v1/personFields'
post_response = requests.post(post_url, params=token, data=post_data)
post_content = json.loads(post_response.content)
# The key 'success' should equal True.
print(post_content['success'])
Если вы успешно создали поле, ответ будет содержать ключ «данные» с информацией поля. Эта информация включает в себя ключ под названием «ключ», который вам понадобится при записи данных в это поле.
field_key = post_content['data']['key']
Написание данных на пользовательские поля Pipedrive
Теперь, когда у вас настраиваемое поле на месте, вы можете написать ему данные. Heads up, справочник API Pipedrive вводит в заблуждение (она кажется, что вы можете писать только данные по по умолчанию, которые на самом деле не так). Чтобы завершить этот шаг, вам нужно найти идентификатор пользователя, который вы хотите написать данные. Чтобы облегчить, вы можете получить список Все ваши пользователи или Поиск конкретных пользователей Отказ
# token should still be defined from the GET request, but in case you skipped over that, here it is again.
token = {
'api_token': 'your-api-token-found-in-the-web-app'
}
# Replace id-of-person with the actual ID
put_url = 'https://your-domain.pipedrive.com/api/v1/persons/id-of-person'
# field_key is the 'key' value of the field that you want to write data to
put_payload = {
field_key: '2021-06-01' # If this person's trial ends on 2021-06-01
}
put_response = requests.put(put_url, params=token, data=put_payload)
put_content = json.loads(put_response.content)
# The key 'success' should equal True.
print(put_content['success'])
Вывод содержит пользователь, который мы только что написали данные, включая вновь добавленные данные. Для наблюдения за тем, чтобы посмотреть, что ключ «Успех» будет равен True, если вам удастся писать данные, независимо от того, были ли данные правильными. Если вы, например, попробуйте записать строку «неправильные данные» в поле Дата, ключ «Успех» будет равна истинно, и значение поля будет установлено на 1970-01-01. Вы захотите проверить результат вашего запроса API, чтобы убедиться, что он точен.
# This should equal the value that you just wrote using the PUT request. print(put_content['data'][field_key])
Успех! Вы просто написали свои данные в пользовательские поля Pipedrive, используя API Pipedrive … один раз.
Есть больше жизни, чем писать на пользовательские поля
Это, само собой, достаточно легко, чтобы написать данные на пользовательское поле через API Pipedrive. Настоящая проблема заключается в том, чтобы получить этот процесс прямо в производстве. Это означает планирование этого процесса периодически запуска. Это также означает убедиться, что вы не превышаете два-секунду, ни 24-часовые пределы ставок, которые также включают в себя любые действия, которые вы принимаете в веб-приложении. Вам также потребуется включить журнал, чтобы вы точно знаете, какие точки данных были успешно написаны и какие из них не удалось (и почему). Кроме того, вам придется разработать процесс, чтобы повторить попытку написания этих неудачных точек данных – и надеюсь, что они снова не проваливаются. Список продолжается.
Вы можете бороться с этим процессом, или вы можете позволить переписи беспокоиться об этом. Мы можем взять на себя все инженеры для пользовательских соединителей с вашей тарелки и облегчить синхронизацию ваших данных клиентов с вашего склада на ваши бизнес-инструменты. Посмотрите, если мы Интеграция с вашими инструментами или проверить Демо Отказ
Оригинал: “https://dev.to/getcensus/pipedrive-api-with-python-how-to-write-to-contact-records-1bg”