Pointagram
pointagramPointagram is a gamification tool that increases motivation and team achievements. Keep your team goal-oriented and celebrate great performance together.
Acciones disponibles (8)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Add ScorePOINTAGRAM_ADD_SCOREAcciónTool to add points to Pointagram players in a score series. Use when you need to award points with optional tags, descriptions, and automatic player creation.
POINTAGRAM_ADD_SCOREAcciónTool to add points to Pointagram players in a score series. Use when you need to award points with optional tags, descriptions, and automatic player creation.
Parámetros de entrada
tagsobject[]Tags displayed with points. Each tag should have a 'name' field.
pointsintegerNumber of points to award. Use this OR pointtype_name.
commentstringDescription visible in the news feed about this score entry.
player_idstringInternal Pointagram player identifier. Use this if you have the player's ID.
score_timestringSets transaction timestamp in datetime format (e.g., ISO 8601).
player_namestringPlayer's display name for identification. Use when player_id is not available.
player_emailstringPlayer's email address for identification. Use when player_id is not available.
create_playerintegerSet to 1 to automatically create missing players. Leave unset or set to 0 to not create players.
pointtype_namestringNamed point type to assign. Use this OR points.
scoreseries_idstringID of the target score series. Use this OR scoreseries_name.
source_score_idstringTransaction identifier. Reusing this ID will revoke the previous entry with the same ID.
scoreseries_namestringName of the target score series. Use this OR scoreseries_id.
player_external_idstringYour system's unique player identifier. Use for integration with external systems.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Competition PlayersPOINTAGRAM_LIST_COMPETITION_PLAYERSAcciónTool to fetch competition players and standings in Pointagram. Returns detailed player rankings, scores, and competition participation data. Use when you need to retrieve player standings, competition leaderboards, or analyze player performance across competitions.
POINTAGRAM_LIST_COMPETITION_PLAYERSAcciónTool to fetch competition players and standings in Pointagram. Returns detailed player rankings, scores, and competition participation data. Use when you need to retrieve player standings, competition leaderboards, or analyze player performance across competitions.
Parámetros de entrada
player_idstringFilter by specific player ID to get their competition participation.
competition_idstringFilter players by specific competition ID. If not provided, returns players from all competitions.
player_external_idstringFilter by external player identifier from your system.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List CompetitionsPOINTAGRAM_LIST_COMPETITIONSAcciónTool to fetch competitions in Pointagram with optional filtering. Use when you need to retrieve competition information including rankings and scores. Supports filtering by player (email, name, external ID), competition ID, or access key.
POINTAGRAM_LIST_COMPETITIONSAcciónTool to fetch competitions in Pointagram with optional filtering. Use when you need to retrieve competition information including rankings and scores. Supports filtering by player (email, name, external ID), competition ID, or access key.
Parámetros de entrada
filterstringThe search value to match against the criteria specified in search_by parameter. Used to filter competitions by player information.
accesskeystringFilter results to show only competitions associated with a specific access key identifier.
search_bystringenumSpecifies the search criteria type to filter competitions by player. Accepts 'Email', 'Name', or 'External Id'. Used in combination with 'filter' parameter.
EmailNameExternal Idcompetition_idanyFilter results to show only a specific competition by its unique ID. When provided, returns data for a single competition.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List PlayersPOINTAGRAM_LIST_PLAYERSAcciónTool to fetch and list players in Pointagram with optional filtering. Use when you need to retrieve player information including name, email, external ID, and status. Supports filtering by email, name, or external ID.
POINTAGRAM_LIST_PLAYERSAcciónTool to fetch and list players in Pointagram with optional filtering. Use when you need to retrieve player information including name, email, external ID, and status. Supports filtering by email, name, or external ID.
Parámetros de entrada
filterstringThe search value to match against the specified search_by field. Used in combination with 'search_by' parameter to filter results.
search_bystringenumSpecifies the search field to filter players. Accepts 'Email', 'Name', or 'External Id'. If provided, 'filter' parameter must also be provided.
EmailNameExternal Id
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Score SeriesPOINTAGRAM_LIST_SCORE_SERIESAcciónTool to list all score series in Pointagram. Use when you need to retrieve all configured score series collections that track and measure different point types.
POINTAGRAM_LIST_SCORE_SERIESAcciónTool to list all score series in Pointagram. Use when you need to retrieve all configured score series collections that track and measure different point types.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Score Series HistoryPOINTAGRAM_LIST_SCORE_SERIES_HISTORYAcciónTool to fetch historical point data for a score series. Returns time-series data of points awarded over time with optional filtering by tags, teams, players, and time range. Use when you need to retrieve historical transaction data for a specific score series.
POINTAGRAM_LIST_SCORE_SERIES_HISTORYAcciónTool to fetch historical point data for a score series. Returns time-series data of points awarded over time with optional filtering by tags, teams, players, and time range. Use when you need to retrieve historical transaction data for a specific score series.
Parámetros de entrada
limitintegerMaximum rows per request (default: 50, maximum: 1000).
time_tostringEnd time in UTC format "YYYY-MM-DD HH:MM:SS".
offset_idstringFor pagination - use previous response's last row ID. Must be used together with offset_timestamp.
time_fromstringStart time in UTC format "YYYY-MM-DD HH:MM:SS".
tags_filterstringFilter by specific tags in JSON format: [{"id":"13","type":1},{"id":"14","type":1}] where type 1=tags, type 2=point type.
show_revokedintegerSet to 1 to include revoked points; default is 0.
teams_filterstringFilter by team IDs in JSON format: ["20"].
player_filterstringFilter by player profile IDs in JSON format: ["19145"].
scoreseriesidintegerObligatorioThe ID of the score series to fetch history for. This is a required parameter.
tags_or_filterstringAlternative tag filtering with OR logic. Same format as tags_filter: [{"id":"13","type":1}].
offset_timestampstringFor pagination - use previous response's last row timestamp. Must be used together with offset_id.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Score Series Point TypesPOINTAGRAM_LIST_SCORE_SERIES_POINT_TYPESAcciónTool to fetch point types for a specific score series in Pointagram. Use when you need to retrieve the different types of points that can be awarded within a score series.
POINTAGRAM_LIST_SCORE_SERIES_POINT_TYPESAcciónTool to fetch point types for a specific score series in Pointagram. Use when you need to retrieve the different types of points that can be awarded within a score series.
Parámetros de entrada
scoreseriesintegerObligatorioId of the score series to fetch Point Types for.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List TeamsPOINTAGRAM_LIST_TEAMSAcciónTool to fetch and list all teams in Pointagram. Returns team information including ID, name, and icon. Use when you need to retrieve all available teams.
POINTAGRAM_LIST_TEAMSAcciónTool to fetch and list all teams in Pointagram. Returns team information including ID, name, and icon. Use when you need to retrieve all available teams.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not