{"id":18470259,"url":"https://github.com/caioagiani/mobizon-api-doc","last_synced_at":"2025-05-12T03:09:25.262Z","repository":{"id":104224519,"uuid":"403115201","full_name":"caioagiani/mobizon-api-doc","owner":"caioagiani","description":"Mobizon API documentation","archived":false,"fork":false,"pushed_at":"2021-10-16T02:55:36.000Z","size":15,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-09T00:12:18.572Z","etag":null,"topics":["api","api-blueprint","api-documentation","api-sms","mobizon","mobizon-doc","sms-api"],"latest_commit_sha":null,"homepage":"https://mobizon.docs.apiary.io/","language":"API Blueprint","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/caioagiani.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-04T17:18:41.000Z","updated_at":"2023-03-17T12:43:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"f1436e79-95c6-4bfd-9c72-14851af7f476","html_url":"https://github.com/caioagiani/mobizon-api-doc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caioagiani%2Fmobizon-api-doc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caioagiani%2Fmobizon-api-doc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caioagiani%2Fmobizon-api-doc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caioagiani%2Fmobizon-api-doc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caioagiani","download_url":"https://codeload.github.com/caioagiani/mobizon-api-doc/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253166524,"owners_count":21864482,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-blueprint","api-documentation","api-sms","mobizon","mobizon-doc","sms-api"],"created_at":"2024-11-06T10:13:25.683Z","updated_at":"2025-05-09T00:12:25.712Z","avatar_url":"https://github.com/caioagiani.png","language":"API Blueprint","funding_links":[],"categories":[],"sub_categories":[],"readme":"FORMAT: 1A\nHOST: https://api.mobizon.com.br/service/\n\n# Mobizon - Manual API\n\n\u003cimg src=\"https://mobizon.com.br/public/documents/0011/6064238d799ebdcb970a882a62d05a80.png\" style=\"width: 100%;\"/\u003e\n\nEsta documentação detalha os endpoints disponíveis na API do [mobizon](https://mobizon.com.br) e disponibiliza um console interativo\npara que você consiga testar as requisições sem ser necessário escrever nenhuma linha de código. Além disso, através\ndo console também é possível gerar automaticamente o código das requisições para diversas liguagens (PHP, Java, Ruby, entre muitas outras)\n\nPara testar os exemplos é necessário criar sua conta e gerar sua chave de acesso. Caso você ainda não tenha, basta\n[criar uma clicando aqui](https://mobizon.com.br/).\n\n\u003cimg src=\"https://mobizon.com.br/public/documents/0011/8ac92d3a71051678c0a32f91676f99be.png?mobizon-api\" style=\"width: 100%;\"/\u003e\n\n## Visão geral\nNossa API oferece a oportunidade de configurar notificações automatizadas por SMS diretamente de qualquer software, CRM ou aplicativo.\n\nPara a comunicação do servidor API, é utilizado um protocolo HTTP, incluindo suporte SSL seguro. As solicitações são enviadas usando os métodos GET e POST, e o servidor responde no formato XML ou JSON, dependendo da sua preferência.\n\n```Atenção! Sua API Key possui privilégios de uso próprio, portanto certifique-se de mantê-la protegida.```\n\n## Status\n\nVeja a tabela de `API response codes`/`SMS status` da API:\n\nPara mais informacoes, [veja aqui](https://github.com/mobizon/mobizon-api-docs).\n\n### API response codes\n\nCode                                        | Type    | Description\n--------------------------------------------|---------|----------------\n\u003cspan data-anchor=\"api-code-0\"\u003e0\u003c/span\u003e     | int | A operação foi completa com sucesso.\n\u003cspan data-anchor=\"api-code-1\"\u003e1\u003c/span\u003e     | int | Erro de validação de dados transmitidos durante a criação ou atualização de qualquer entidade. O campo de dados fornece informações sobre os campos preenchidos incorretamente. Corrija os erros e repita a solicitação com novos dados.\n\u003cspan data-anchor=\"api-code-2\"\u003e2\u003c/span\u003e     | int | A entrada solicitada não foi encontrada. É provável que seja excluído, o ID da entrada está incorreto ou o usuário que tenta acessar a entrada não possui os direitos de acesso apropriados para ela.\n\u003cspan data-anchor=\"api-code-3\"\u003e3\u003c/span\u003e     | int | Ocorreu um erro de aplicativo não identificado. Entre em contato com a equipe de suporte e nos informe os detalhes da solicitação para a qual foi recebido.\n\u003cspan data-anchor=\"api-code-4\"\u003e4\u003c/span\u003e     | int | O parâmetro \"`module`\" está incorreto. Verifique a documentação API.\n\u003cspan data-anchor=\"api-code-5\"\u003e5\u003c/span\u003e     | int | O parâmetro \"`method`\" está incorreto. Verifique a documentação API.\n\u003cspan data-anchor=\"api-code-6\"\u003e6\u003c/span\u003e     | int | O parâmetro \"`format`\" está incorreto. Verifique a documentação API.\n\u003cspan data-anchor=\"api-code-8\"\u003e8\u003c/span\u003e     | int | Falha na autenticação. O erro ocorre se: 1. Os detalhes de login estão incorretos. 2. Quando uma sessão do usuário expirou durante a operação do sistema ou foi fechada à força pelo servidor. Para obter informações detalhadas, consulte o campo \"`message`\".\n\u003cspan data-anchor=\"api-code-9\"\u003e9\u003c/span\u003e     | int | Erro de acesso ao método obrigatório.\n\u003cspan data-anchor=\"api-code-10\"\u003e10\u003c/span\u003e   | int | Erro ao salvar dados do servidor diretamente durante esta operação. Normalmente este erro está relacionado ao acesso simultâneo aos dados de vários clientes ou alterações nas condições de salvamento dos dados.\n\u003cspan data-anchor=\"api-code-11\"\u003e11\u003c/span\u003e   | int | Alguns dos parâmetros necessários estão faltando na requisição. Verifique a documentação API e adicione os parâmetros necessários.\n\u003cspan data-anchor=\"api-code-12\"\u003e12\u003c/span\u003e   | int | O parâmetro de entrada da solicitação não está em conformidade com as condições ou restrições especificadas. Este código de erro ocorre quando um parâmetro viola as restrições ao executar uma solicitação com parâmetros. Parece um erro de validação de atributo, mas pode ser recebido em solicitações não destinadas à criação ou modificação de dados.\n\u003cspan data-anchor=\"api-code-13\"\u003e13\u003c/span\u003e   | int | Uma tentativa de solicitar o servidor API que não atende a este usuário. Se você receber este código, procure o domínio correto no campo \"`data`\".\n\u003cspan data-anchor=\"api-code-14\"\u003e14\u003c/span\u003e   | int | Este erro ocorre se a conta do usuário foi **bloqueada** ou **removida**.\n\u003cspan data-anchor=\"api-code-15\"\u003e15\u003c/span\u003e   | int | Ocorreu um erro durante a execução de qualquer operação não relacionada à atualização de dados. Os detalhes desse erro estão listados no campo \"`message`\" da resposta da API.\n\u003cspan data-anchor=\"api-code-30\"\u003e30\u003c/span\u003e   | int | O excesso de operações permitidas limita o erro dentro de um intervalo de tempo específico. Este erro ocorre devido a solicitações excessivamente frequentes para o mesmo método de API. Caso ocorra, reduza a frequência das solicitações.\n\u003cspan data-anchor=\"api-code-98\"\u003e98\u003c/span\u003e   | int | A operação não foi realizada totalmente, mas com parte dos dados. Normalmente, você obtém este código para qualquer operação em massa, durante a execução da qual alguns elementos não foram processados devido a erros ou restrições, mas outros foram processados. Ao receber este código, pode verificar a informação dos elementos processados e não processados e procurar erros no conteúdo do campo \"`data`\".\n\u003cspan data-anchor=\"api-code-99\"\u003e99\u003c/span\u003e   | int | Nenhum dos elementos de operação em massa não foi processado. Para obter informações detalhadas sobre os erros em cada elemento específico, verifique o campo \"dados\", para a descrição geral do erro - o campo \"`message`\".\n\u003cspan data-anchor=\"api-code-100\"\u003e100\u003c/span\u003e | int | Este código não é um erro e significa que a operação é executada como um processo em segundo plano. Neste caso, o campo \"`data`\" contém o ID do processo em segundo plano, cujo estado pode ser verificado usando o método `Taskqueue::GetStatus`.\n\u003cspan data-anchor=\"api-code-999\"\u003e999\u003c/span\u003e | int | Erro geral. Para obter detalhes, verifique o campo \"`message`\".\n\n\n### SMS status\nStatus   | Final         | Description\n---------|---------------|------------------------------------\n`NEW`    |      não      | Nova mensagem, ainda não enviada.\n`ENQUEUD`|      não      | Passou na moderação e entrou na fila para envio.\n`ACCEPTD`|      não      | Enviado do sistema e aceito pela operadora para posterior envio ao destinatário.\n`UNDELIV`|      sim      | Não entregue ao destinatário.\n`REJECTD`|      sim      | Recusado pela operadora por um de vários motivos - **número do destinatário errado**, **texto proibido**, **remetente bloqueado pelo destinatário ou vice-versa**, etc..\n`PDLIVRD`|      não      | Nem todos os segmentos de mensagem foram entregues ao destinatário (esse status se aplica apenas a mensagens, mas não a segmentos). Algumas operadoras retornam um relatório de entrega apenas para o primeiro segmento da mensagem longa, é por isso que o status de tais mensagens será alterado para `DELIVRD` após o período de expiração.\n`DELIVRD`|      sim      | Entregue ao destinatário totalmente.\n`EXPIRED`|      sim      | A entrega falhou porque a mensagem expirou (**3 dias por padrão**).\n`DELETED`|      sim      | Excluído devido a restrições e não entregue ao destinatário.\n\n## Suporte\nCaso haja dúvidas ou encontrar algum problema, envie email para suporte@mobizon.com.br.\n\n## Módulo Mensagem SMS [/message]\n\n### Envio de mensagem única [POST /message/sendSmsMessage]\n\nPermite enviar uma única mensagem para um número de celular especificado, mais detalhes: [#SendSmsMessage](https://mobizon.com.br/en/help/api-docs/message#SendSmsMessage).\n\n+ Request (application/x-www-form-urlencoded)\n    \n    + Attributes\n    \n        + apiKey (string, required) - Sua Key da API (você precisa obtê-la em seu painel de controle).\n        + output (string, optional) - Formato de resposta do servidor.\n            + Default: `json`\n        + api (string, optional) - Versão da API.\n            + Default: `v1`\n        + recipient (string, required) - Número de telefone do destinatário em formato internacional (sem incluir o caractere +), ex.: 5511941439844.\n        + text (string, required) - Texto da sua mensagem SMS no formato de string URL encoded: \"Texto da mensagem aqui!\".\n        + from (string, optional) - Seu Sender ID (assinatura alfanumérica). Se nenhum for fornecido, seu Sender ID padrão será usado ou, se você não tiver nenhum, o Sender ID padrão do sistema.\n\n    + Headers\n\n            Cache-control: no-cache\n            \n    + Body \n\n            recipient=5511941439844\u0026text=Mobizon SMS API\u0026from=\u0026output=json\u0026api=v1\u0026apiKey=brXXXXXXXXXXXXXX\n\n\n+ Response 200 (application/json)\n\n    + Body\n\n            {\n              \"code\": 0,\n              \"data\": {\n                \"campaignId\": \"1111111\",\n                \"messageId\": \"11111111\",\n                \"status\": 2\n              },\n              \"message\": \"\"\n            }\n\n### Lista de mensagens SMS [POST /message/List]\n\nLista todas as mensagens SMS enviadas, mais detalhes: [#List](https://mobizon.com.br/en/help/api-docs/message#List).\n\n+ Request (application/x-www-form-urlencoded)\n    \n    + Attributes \n    \n        + apiKey (string, required) - Sua Key da API (você precisa obtê-la em seu painel de controle).\n        + output (string, optional) - Formato de resposta do servidor.\n            + Default: `json`\n        + api (string, optional) - Versão da API.\n            + Default: `v1`\n        + criteria (array[ListSMS], optional)\n        + pagination (array[Pagination], optional)\n        + sort (array[Sort], optional)\n      \n    \n    + Headers\n\n            Cache-control: no-cache\n            \n    + Body \n\n            criteria%5Bfrom%5D=\u0026pagination%5BcurrentPage%5D=2\u0026pagination%5BpageSize%5D=50\u0026sort%5BcampaignId%5D=ASC\u0026apiKey=brXXXXXXXXXXXXXX\n\n\n+ Response 200 (application/json)\n\n    + Body\n\n            {\n              \"code\": 0,\n              \"data\": {\n                \"items\": [\n                  {\n                    \"contentProviderName\": null,\n                    \"partnerId\": \"8\",\n                    \"userId\": \"11111\",\n                    \"usedStopListWords\": null,\n                    \"countryA2\": null,\n                    \"operatorName\": null,\n                    \"id\": \"11111\",\n                    \"campaignId\": \"333333333\",\n                    \"segNum\": \"1\",\n                    \"segUserBuy\": \"0.0600\",\n                    \"status\": \"DELIVRD\",\n                    \"uuid\": \"bb1a64f6-0017-1a8a-9fa7-xxxxxxxxxxx\",\n                    \"from\": \"N-666666\",\n                    \"to\": \"5511941439844\",\n                    \"groups\": null,\n                    \"text\": \"Mobizon SMS API\",\n                    \"startSendTs\": \"2021-09-04 13:31:12\",\n                    \"statusUpdateTs\": \"2021-09-04 13:31:19\",\n                    \"contactCardId\": null,\n                    \"contentProviderId\": null,\n                    \"segPartnerSell\": null,\n                    \"segPartnerBuy\": null,\n                    \"segSystemSell\": null,\n                    \"segSystemBuy\": null,\n                    \"systemCurrency\": null,\n                    \"campaign\": {\n                      \"commonStatus\": \"DONE\",\n                      \"counters\": {\n                        \"campaignId\": \"399768\",\n                        \"updateTs\": \"2021-09-04 13:31:29\",\n                        \"totalNewSegNum\": \"0\",\n                        \"totalEnqueudSegNum\": \"0\",\n                        \"totalAcceptdSegNum\": \"0\",\n                        \"totalDelivrdSegNum\": \"1\",\n                        \"totalRejectdSegNum\": \"0\",\n                        \"totalExpiredSegNum\": \"0\",\n                        \"totalUndelivSegNum\": \"0\",\n                        \"totalDeletedSegNum\": \"0\",\n                        \"totalUnknownSegNum\": \"0\",\n                        \"totalPdlivrdSegNum\": \"0\",\n                        \"totalSegNum\": \"1\",\n                        \"totalNewMsgNum\": \"0\",\n                        \"totalEnqueudMsgNum\": \"0\",\n                        \"totalAcceptdMsgNum\": \"0\",\n                        \"totalDelivrdMsgNum\": \"1\",\n                        \"totalRejectdMsgNum\": \"0\",\n                        \"totalExpiredMsgNum\": \"0\",\n                        \"totalUndelivMsgNum\": \"0\",\n                        \"totalDeletedMsgNum\": \"0\",\n                        \"totalUnknownMsgNum\": \"0\",\n                        \"totalPdlivrdMsgNum\": \"0\",\n                        \"totalMsgNum\": \"1\",\n                        \"totalCost\": \"0.0600\",\n                        \"totalPartnerCost\": \"0.0500\",\n                        \"totalNewMsgCost\": \"0.0000\",\n                        \"totalEnqueudMsgCost\": \"0.0000\",\n                        \"totalAcceptdMsgCost\": \"0.0000\",\n                        \"totalDelivrdMsgCost\": \"0.0600\",\n                        \"totalRejectdMsgCost\": \"0.0000\",\n                        \"totalExpiredMsgCost\": \"0.0000\",\n                        \"totalUndelivMsgCost\": \"0.0000\",\n                        \"totalDeletedMsgCost\": \"0.0000\",\n                        \"totalUnknownMsgCost\": \"0.0000\",\n                        \"totalPdlivrdMsgCost\": \"0.0000\",\n                        \"partnerCurrency\": \"BRL\",\n                        \"userCurrency\": \"BRL\",\n                        \"recipientsRejected\": \"0\"\n                      },\n                      \"createTs\": \"2021-09-04 13:31:11\",\n                      \"creationWay\": \"1\",\n                      \"currency\": null,\n                      \"deferredToTs\": null,\n                      \"endSendTs\": \"2021-09-04 13:31:19\",\n                      \"expirationTs\": \"2021-09-03 07:31:29\",\n                      \"extra\": {\n                        \"validity\": \"1440\",\n                        \"mclass\": \"1\",\n                        \"isTestAlphanameUsed\": true,\n                        \"coding\": \"0\",\n                        \"charset\": \"UTF-8\",\n                        \"trackShortLinkRecipients\": 0\n                      },\n                      \"from\": \"SMS\",\n                      \"globalComment\": null,\n                      \"globalModStatus\": \"AUTO_READY_FOR_SEND\",\n                      \"groups\": null,\n                      \"groupsList\": [],\n                      \"highlightedText\": null,\n                      \"id\": \"399768\",\n                      \"isTemplateComment\": null,\n                      \"moderationStatus\": \"READY_FOR_SEND\",\n                      \"msgType\": \"SMS\",\n                      \"name\": null,\n                      \"partnerId\": \"8\",\n                      \"partnerModStatus\": \"AUTO_READY_FOR_SEND\",\n                      \"rateLimit\": null,\n                      \"ratePeriod\": null,\n                      \"recipientsSource\": null,\n                      \"sendStatus\": \"DONE\",\n                      \"startSendTs\": \"2021-09-04 13:31:12\",\n                      \"text\": \"Mobizon SMS API\",\n                      \"type\": \"1\",\n                      \"usedStopListWords\": null,\n                      \"userId\": \"1111111\"\n                    }\n                  }\n                ],\n                \"totalItemCount\": \"1\"\n              },\n              \"message\": \"\"\n            }\n\n### Relatório de status de entrega SMS [POST /message/GetSMSStatus]\n\nO método aceita uma string com um ID de mensagem e uma matriz de IDs de mensagem. Independentemente do tipo do parâmetro de entrada, o resultado retornado é sempre representado como uma matriz. Se você enviar IDs de mensagens inexistentes ou não pertencentes aos usuários, o resultado não conterá informações sobre essas mensagens, mais detalhes: [#GetSMSStatus](https://mobizon.com.br/en/help/api-docs/message#GetSMSStatus).\n\n+ Request (application/x-www-form-urlencoded)\n    \n    + Attributes\n    \n        + apiKey (string, required) - Sua Key da API (você precisa obtê-la em seu painel de controle).\n        + output (string, optional) - Formato de resposta do servidor.\n            + Default: `json`\n        + api (string, optional) - Versão da API.\n            + Default: `v1`\n        + ids (array[string], optional) - Message ID(s) is (are) an array or a string of Ids, separated by commas. Maximum equals to 100 characters.\n        \n    + Headers\n\n            Cache-control: no-cache\n            \n    + Body \n\n            ids%5B0%5D=123\u0026ids%5B1%5D=556\u0026ids%5B2%5D=988\n\n\n+ Response 200 (application/json)\n\n    + Body\n\n            {\n              \"code\": 0,\n              \"data\": [\n                {\n                  \"id\": \"123\",\n                  \"status\": \"DELIVRD\",\n                  \"segNum\": \"1\",\n                  \"startSendTs\": \"2021-09-04 13:28:29\",\n                  \"statusUpdateTs\": \"2021-09-04 13:28:35\"\n                }\n              ],\n              \"message\": \"\"\n            }\n\n# Data Structures\n\n## SendSMS\n\n+ apiKey (string, required) - Sua Key da API (você precisa obtê-la em seu painel de controle).\n+ recipient (string, required) - Número de telefone do destinatário em formato internacional (sem incluir o caractere +), ex.: 5511963928063.\n+ text (string, required) - Texto da sua mensagem SMS no formato de string URL encoded: \"Texto da mensagem aqui!\".\n+ from (string, optional) - Seu Sender ID (assinatura alfanumérica). Se nenhum for fornecido, seu Sender ID padrão será usado ou, se você não tiver nenhum, o Sender ID padrão do sistema.\n+ output (string, optional) - Formato de resposta do servidor.\n    + Default: `json`\n+ api (string, optional) - Versão da API.\n    + Default: `v1`\n    \n## ListSMS\n\n+ id (number, optional) - ID da mensagem\n+ campaignId (number, optional) - ID da campanha\n+ campaignIds (array, optional) - Pesquisa por IDs de campanha; o parâmetro deve ser passado como uma matriz ou string de IDs, separados por vírgulas, o número máximo de IDs é igual a 10\n+ from (string, optional) - Assinatura do remetente\n+ to (string, optional) - Número do destinatário\n+ text (string, optional) - Mensagem de texto\n+ status (number, optional) - Status da mensagem\n+ groups (string, optional) - Grupos de destinatários de mensagens\n+ contentProviderId (string, optional) - SMS centre ID\n    \n## Pagination\n\n+ pageSize (number, optional) - Número de elementos visíveis na página\n+ currentPage (number, optional) - Pagina atual\n\n## Sort\n+ id (number, optional) - ID da mensagem\n+ campaignId (number, optional) - ID da campanha\n+ from (number, optional) - Assinatura do remetente\n+ to (number, optional) - Número do destinatário\n+ text (number, optional) - Message text\n+ status (number, optional) - Mensagem de texto\n+ groups (number, optional) - Grupos de destinatários de mensagens\n+ contentProviderId (number, optional) - SMS centre ID\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaioagiani%2Fmobizon-api-doc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaioagiani%2Fmobizon-api-doc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaioagiani%2Fmobizon-api-doc/lists"}