Как можно добавить примечание к сделке через API AmoCRM?

Question

Dylan

api , amocrm

Как можно добавить примечание к сделке через API AmoCRM?

Здравствуйте! Я передаю заявки с сайта в amoCRM и создаю следующий массив:<br/><br/><pre><code class="php">$data = [
   	[
       'name' =&gt; $title,
       "responsible_user_id" =&gt; (int) $user_amo,
       "pipeline_id" =&gt; (int) $pipeline_id, 
   
       "_embedded" =&gt; [
           "contacts" =&gt; [
                [
                    "first_name" =&gt; $fio,
                    "custom_fields_values" =&gt; [
                        [
                            "field_code" =&gt; "EMAIL",
                            "values" =&gt; [
                                [
                                    "enum_code" =&gt; "WORK",
                                    "value" =&gt; $email
                                ]
                            ]
                        ],
                        [
                            "field_code" =&gt; "PHONE",
                            "values" =&gt; [
                                [
                                    "enum_code" =&gt; "MOB",
                                    "value" =&gt; $phone
                                ]
                            ]
                        ],
                    ]
                ]
            ],
        ],
      ]
   ];</code></pre><br/><br/> Сделка успешно попадает в amoCRM, но как можно добавить примечание к сделке? Возможно ли это сделать внутри массива? Я не смогла разобраться в документации, и пока мои попытки не увенчались успехом. Можете подсказать, как правильно это реализовать? Я использую метод $method = "/api/v4/leads/complex";<br/><br/> Я пыталась добавить примечание в массив следующим образом:<br/><pre><code class="php">"notes" =&gt; [
            {
                "note_type" =&gt; "common",
                "params</code></pre>

22 марта 2025 г. 10:54

Ответы на вопрос 2

Похожие вопросы

Answer 1

Для добавления примечания к сделке в amoCRM через API, вы можете использовать вложенный массив в `notes` внутри массива сделки. Однако, поле `notes` не является частью структуры сделок в API amoCRM, а следует отправить примечания в виде отдельного запроса после создания сделки.

Вот шаги, которые вам необходимо выполнить:

1. Создайте сделку, как вы это делаете сейчас.
2. После успешного создания сделки, получите ID созданной сделки.
3. Используйте этот ID для отправки отдельного запроса на добавление примечания к сделке.

### Пример кода

1. Код для создания сделки:

```php
$data = [
    [
        'name' => $title,
        "responsible_user_id" => (int) $user_amo,
        "pipeline_id" => (int) $pipeline_id,
        "_embedded" => [
            "contacts" => [
                [
                    "first_name" => $fio,
                    "custom_fields_values" => [
                        [
                            "field_code" => "EMAIL",
                            "values" => [
                                [
                                    "enum_code" => "WORK",
                                    "value" => $email
                                ]
                            ]
                        ],
                        [
                            "field_code" => "PHONE",
                            "values" => [
                                [
                                    "enum_code" => "MOB",
                                    "value" => $phone
                                ]
                            ]
                        ],
                    ]
                ]
            ],
        ],
    ]
];

// Выполните запрос для создания сделки
$response = $amo->request('/api/v4/leads/complex', 'POST', $data);
```

2. Код для добавления примечания:
```php
$leadId = $response['_embedded']['leads'][0]['id']; // Получите ID созданной сделки

$noteData = [
    [
        "note_type" => "common",
        "params" => [
            "text" => "Ваше примечание здесь"
        ]
    ]
];

// Выполните запрос для добавления примечания
$amo->request("/api/v4/leads/$leadId/notes", 'POST', $noteData);
```

### Что еще важно учесть

- Убедитесь, что вы используете правильные HTTP-заголовки, включая авторизацию.
- Проверьте документацию amoCRM по API, чтобы убедиться, что вы используете правильные эндпоинты и данные.
- Обработайте возможные ошибки, чтобы убедиться, что запросы выполняются успешно.

Таким образом, примечание не добавляется в массив сделки, а отправляется уже после успешного создания самой сделки.

Answer 2

Одним запросом вы это не сделаете. Вам надо создать сделку, из ответа получить ее id и использовать запрос на создание примечания