API docs
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

API Merdan bot

Формирование запроса

Обязательные параметры:

Адрес: ‘https://api.alexvamp.ru/webhook/merdan/telecom/v1'

Метод запроса: POST

В Headers передаём (крайне желательно) uuid любой версии в виде “215a2da8-8a0e-496a-a51b-341d696f53f3” для каждого диалога. По факту это просто идентификатор диалога и он может быть любым. По нему система может определить уникальный идентификатор текущего разговора и не создавать новый, а продолжить существующий. В случае отсутствия uuid в Headers, все диалоги смешиваются в один. Авторизация производится методом передачей параметра “Authorization” в Headers. Пароль запросить у разработчиков. В теле запроса “Body” чистыми данными в кодировке utf-8 передаём сам запрос.

Не обязательные переменные:

Если вы хотите чтобы бот отвечал на конкретном языке, вы также можете указывать язык заранее добавив в Headers переменную “lang”. На данный момент поддерживаемые языки: русский, туркменский, английский, китайский. (ru, tk, en, cn). В ближайшее время будет добавлено ещё около 15 языков. Если вам нужен какой-то язык прямо сейчас, обратитесь к разработчикам.

Lang: ru

Примеры:

cURL:

curl --location 'https://api.alexvamp.ru/webhook/merdan/telecom/v1' \
--header 'Authorization: 268ccq0a-7rjt-431e-92c3-0f02f37e6e37' \
--header 'uuid: 215a2da8-8a0e-496a-a51b-341d696f53f3' \
--header 'Content-Type: text/plain; charset=UTF-8' \
--data 'Давай знакомиться. Меня зовут Алексей.'

Go:

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://api.alexvamp.ru/webhook-test/merdan/telecom/v1"
  method := "POST"

  payload := strings.NewReader(`Давай знакомиться. Меня зовут Алексей.`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "text/plain; charset=UTF-8")
  req.Header.Add("uuid", "215a2da8-8a0e-496a-a51b-341d696f53f3")
  req.Header.Add("Authorization", "268ccq0a-7rjt-431e-92c3-0f02f37e6e37")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Python:

import requests

url = "https://api.alexvamp.ru/webhook-test/merdan/telecom/v1"

payload = "Давай знакомиться. Меня зовут Алексей."
headers = {
  'Content-Type': 'text/plain; charset=UTF-8',
  'uuid': '215a2da8-8a0e-496a-a51b-341d696f53f3',
  'Authorization': '268ccq0a-7rjt-431e-92c3-0f02f37e6e37'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

JavaScript - jQuery:

var settings = {
  "url": "https://api.alexvamp.ru/webhook-test/merdan/telecom/v1",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "text/plain; charset=UTF-8",
    "uuid": "215a2da8-8a0e-496a-a51b-341d696f53f3",
    "Authorization": "268ccq0a-7rjt-431e-92c3-0f02f37e6e37"
  },
  "data": "Давай знакомиться. Меня зовут Алексей.",
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Ответ

ответ от системы придёт в кодировке utf-8 в формате JSON:

{
"output": "Здравствуйте, Алексей! Очень приятно познакомиться. 
Меня зовут Мердан, я консультант интернет-провайдера ТуркменТелеком. 
Чем я могу вам помочь сегодня? Возможно, у вас есть вопросы о наших услугах или тарифах?"
}