fmconsult-chat-api-python-sdk 1.0.0

Client de comunicação c/ FMConsult Chat API

fmconsult-chat-api-python-sdk

Client Python para a FMConsult Chat API.

Instalação

pip install fmconsult-chat-api-python-sdk fmconsult-utils-python-sdk

Variáveis de ambiente

Variável	Obrigatório	Descrição
fmconsult.chat.api.token	sim	Token X-Api-Token (gerado via fmconsult-apis-manager)
fmconsult.chat.api.client_id	sim	Tenant enviado em X-Client-Id
fmconsult.chat.api.base_url	não	Padrão: https://api-chat.fmconsult.com.br

Uso na core-api

import os
from fmconsult.utils.configs import ConfigPropertiesHelper
from fmconsult.chatapi.apis.rooms import Rooms
from fmconsult.chatapi.apis.messages import Messages
from fmconsult.chatapi.dtos.room import CreateRoom, JoinRoom
from fmconsult.chatapi.dtos.message import SendMessage, MessageVisibility

def init_chat_environments():
  cph = ConfigPropertiesHelper()
  os.environ['fmconsult.chat.api.token'] = cph.get_property_value('FMCONSULT-CHAT', 'fmconsult.chat.api.token')
  os.environ['fmconsult.chat.api.client_id'] = cph.get_property_value('FMCONSULT-CHAT', 'fmconsult.chat.api.client_id')

# Criar sala
init_chat_environments()
rooms = Rooms()
room = rooms.create(CreateRoom(
  name='Sala Pedido',
  reference_id='64ad60d266a2f523e0ee30e7',
  color='#000000',
))

# Entrar na sala
rooms.join(room['data']['id'], JoinRoom(
  user_id='64b82ab5cc7e070e429aef43',
  name='John Doe',
  profile='passenger',
  phone_number='11 999999999',
  departments=['operacao'],
  roles=['user'],
))

# Enviar mensagem
messages = Messages()
messages.send(room['data']['id'], SendMessage(
  user_id='64b82ab5cc7e070e429aef43',
  content='Olá!',
))

# Mensagem direta
messages.send(room['data']['id'], SendMessage(
  user_id='64b82ab5cc7e070e429aef43',
  content='Privado',
  visibility=MessageVisibility(
    type='direct',
    users=['64dbb6ded80a591d2df65621'],
  ),
))

# Listar mensagens
messages.list_by_room(room['data']['id'], user_id='64b82ab5cc7e070e429aef43')

# Última mensagem visível
messages.get_latest(room['data']['id'], user_id='64b82ab5cc7e070e429aef43')

Config na core-api (configs.ini)

[FMCONSULT-CHAT]
fmconsult.chat.api.token=seu-token
fmconsult.chat.api.client_id=77seg
fmconsult.chat.api.base_url=https://api-chat.fmconsult.com.br

Publicação

Push de tag v* dispara o workflow de publicação no PyPI.

git tag v1.0.0
git push origin v1.0.0

Dependências

Este pacote depende de fmconsult-utils-python-sdk em runtime (instalado separadamente pelo consumidor, como nos demais SDKs internos).