GREEN-API Test UI (Go)

Небольшое веб-приложение на Go для тестирования основных методов GREEN-API:

• getSettings
• getStateInstance
• sendMessage
• sendFileByUrl

Приложение поднимает локальный UI и проксирует запросы к GREEN-API.

Требования

• Go 1.21+
• Активный инстанс GREEN-API
• idInstance и apiTokenInstance

Быстрый старт (Windows / PowerShell)

Set-Location "E:\work\hh.ru\test_GreenAPI"
go run .

После запуска откройте:

• http://localhost:8080/

Deploy на Vercel

Проект готов для Vercel serverless:

• добавлен Handler в main.go для serverless-вызова;
• добавлен vercel.json с роутингом всех путей на Go entrypoint.

Если деплой делаете через GitHub:

• импортируйте репозиторий в Vercel;
• Framework Preset: Other;
• Build/Output настройки можно оставить по умолчанию.

Как это работает

• UI отдается из встроенного файла static/index.html (через embed).
• Backend предоставляет локальные POST-эндпоинты:
  • /api/getSettings
  • /api/getStateInstance
  • /api/sendMessage
  • /api/sendFileByUrl
• Для вызовов GREEN-API используется базовый URL:
  • по умолчанию: https://api.green-api.com
  • можно переопределить полем apiUrl в теле запроса.

Формат данных

Обязательные поля для всех методов:

• idInstance
• apiTokenInstance

Дополнительно:

• для sendMessage:
  • phone (международный формат, только цифры или с символами)
  • message
• для sendFileByUrl:
  • phone
  • urlFile

Телефон автоматически приводится к формату [email protected].

Частые ошибки

• run : The term 'run' is not recognized...

  • Используйте go run ., а не run go ..

• listen tcp :8080: bind ...

  • Порт 8080 уже занят другим процессом. Остановите его или измените порт в коде (addr := ":8080" в main.go).

• Vercel: 500 FUNCTION_INVOCATION_FAILED

  • Обычно это происходит, когда приложение пытается запускать собственный сервер в serverless-среде.
  • В текущей версии это исправлено через serverless Handler + vercel.json.

Структура проекта

• main.go — HTTP-сервер, валидация входных данных, проксирование в GREEN-API
• static/index.html — интерфейс для ручного тестирования методов
• go.mod — модуль и версия Go