> For the complete documentation index, see [llms.txt](https://geontacom.gitbook.io/geontacom/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://geontacom.gitbook.io/geontacom/geontacom-user-manual.md). # Geontacom User Manual ### 1. Introduction Welcome to Geontacom, your comprehensive solution for streamlined communication through bulk SMS and Email. Designed with versatility and efficiency in mind, our web application empowers businesses, organizations, and individuals to effortlessly connect with their audience on a large scale. ### 2. Product Overview Geontacom is a feature-rich web application designed for comprehensive mass communication, featuring seamless email and text SMS messaging capabilities. Key features include: * **Email Sending via SMTP:** Reliable and secure email communication facilitated through SMTP integration. * **Text SMS Messaging**: Utilization of popular SMS API gateways. * **Campaign Management:** Empowers both users and admins to create, manage, and track campaigns efficiently, enhancing targeted and strategic messaging. * **Multiple Gateway Integration:** Add and manage multiple gateways, enabling diverse choices for SMS and email providers. * **Subscription Plans:** Dynamic subscription plans that allow users to have a more robust business model. * **Queue System for Bulk Requests:** Smooth handling of bulk messaging requests through a robust Laravel Queue system. ### 3. Getting Started To access Geontacom, please visit . If you are a new user, you will need to create an account to get started with our services. Click the “Get Started“ button located on the homepage. You’ll be required to provide your name, email and create a password for your account. Please ensure that you use a valid email address as it will be used for account verification and communication purposes. If you already have an account, simply click on the “Sign In“ button located on the navigation bar on the homepage. Enter your registered email address and password in the designated fields. Afterward, you'll be directed to the user dashboard. In case you forget your password, you can reset it by clicking on the “**Forgot Password**“ link on the login page. Follow the instructions to reset your password. ### 4. Navigating the User Dashboard Once you’ve successfully registered or logged in into Geontacom, you’ll be directed to your user dashboard. Here, you’ll find a centralized hub for managing your account, contacts messages and emails. Lets take a closer look on how to navigate the user dashboard: * **Dashboard Overview** Upon logging in, you'll be greeted with an overview of your dashboard.

* **Top Bar Navigation** At the top of your user dashboard, you’ll find a navigation bar that provides quick access to various tools and settings.

Here is a breakdown of the different options available: **1. Dashboard Expansion** To maximize your workspace, you can expand the dashboard by clicking on the expand icon. This will hide the sidebar giving you a full screen view of your dashboard.

**2. Back to Website** Need to navigate back to our website for more information? Simply click on the globe icon. This will redirect you to our main website where you can explore additional resources, or learn more about our services.

**3. Profile**

This section allows you manage you account settings. Click on your profile name or photo to access options such as: **a.** ***Profile Setting*** Update your personal information, including name, email address and profile picture. **b. *****Password Update*** Change your account password for security purposes. **c. *****Logout*** Logout of the dashboard. You will be redirected to the website. * **Sidebar Navigation** Located on the left-hand side of your user dashboard, the sidebar provides easy access to various features and functionalities of our application.

Here is a detailed overview of each item in the sidebar: **1. Dashboard Overview** The dashboard overview section provides a snapshot of your recent activity, remaining SMS and Email credits, SMS and Email statistics and credit and transaction logs.

**2. Subscription** Within the Subscription section, you can explore our available plans and choose the subscription that best fits your needs. **2a. *****Plan*** Browse through our various plans tailored to suit different usage levels and requirements. Each plan offers unique features and benefits designed to optimize your messaging experience.

**2b. *****Subscription*** Discover the types of subscriptions available, including monthly, yearly and custom plans.

**3. SMS Message** The SMS Message section allows you to manage and send SMS messages effectively. To send a message, you need to first top up so that you can buy SMS credits. To top up credit, click on the “Top up Credit “ button on your dashboard.

A popup will appear requiring you to enter the amount you wish to spend on the SMS messages. After paying for the credit, your credits will now increase and you can easily send SMS messages. Visit the send message part so that you can set a target audience, select the message type and select an SMS gateway type.

Here is a breakdown of this section components: **3a. Send Message** ***(i). Set Target Audience*** Choose your recipients from various options, including sending to a single audience, a group audience, or importing contacts from a csv or excel file.

**(*****1*****). Single Audience** Send an SMS message to a single person by entering their phone number in the single input form.

**(*****2*****). Group Audience** Send an SMS message to a group of contacts that you have created in the SMS Phonebook section.

**(*****3*****). Import File** Import a file with contact then send a message to those contacts. Examples of files are a like an excel sheet or csv file, with contacts that you want to send an SMS message to. There is a sample of files that you can download.

***(ii). Schedule and message*** Select the type of message you wish to send and schedule your messages to be sent at a later date and time at this part. ***(1).***** Message Type** Select between standard text messages or unicode messages to accommodate special characters or non-Latin scripts.

***(2).***** Schedule Message** Schedule your messages to be sent at a later date and time, ensuring timely delivery and optimal engagement. Click on the calendar icon to choose the date when you want your message to be sent. A calendar will be displayed, allowing you to select the desired date and time for your message to be sent.

***(iii).***** Gateway Selection** Choose from multiple gateways for sending your SMS messages, allowing you to optimize delivery rates and costs. Click on the dropdown arrow next to the Gateway Selection field. This action will prompt a list to appear, displaying all the available gateway options.

***(iv).***** Write Message** ***(1)*****. Message** Compose your message effortlessly using the provided form. Input your message content, personalize it to resonate with your audience, and ensure it effectively communicates your intended message.

***(2).***** Record Message** Utilize the record button to capture your message via audio instead of typing it. This feature adds a personal touch to your communications and caters to diverse user preferences.

***(4).***** Submit** Once you've finalized your message content, options, and preferences, simply click the submit button to dispatch your message to the selected audience.

**3b. Message History** View a detailed history of all SMS messages sent from your account. This includes information such as sender, recipients, credits, delivery status, and timestamps.

**3c. Campaigns** Create, manage, and track campaigns efficiently, enhancing targeted and strategic messaging. Click on the “Add New“ button to add a campaign.

You will required to enter your campaign name, the target audience , the type of message you want to send and also select the gateway type that you want to use.

You can also schedule when to send the campaign. Click on the calendar icon to choose the date when you want your message to be sent. A calendar will be displayed, allowing you to select the desired date and time for your message to be sent. You can also set how often you want to repeat the campaign and select when to repeat the campaign. After that submit your campaign.

**4. Email Control** The Email Control section allows you to manage and send emails effectively. To be able to send email messages, you are required to first configure your email gateway. To configure your email gateway, go to the “Gateway Section“ on the sidebar. Click on the Email part. On the mail configuration page, there is a “+“ button at the bottom-right corner of the page. Click on that button and a page for adding new mail gateway will popup.

You will be required to select the gateway type that you want. There are several gateway types that we have including SMTP, SendGrid, AWS, Mailjet and Mailgun. You will be required to fill the name and address from which the emails will be sent and also the status of the gateway whether it is active or inactive.

Submit the new gateway. Every user is allocated 30 free Email Credits. When the free credits are over or you wish you add more email credits you can buy a subscription plan. Click the “Buy Credit“ button on the dashboard to see the available plans.

After that visit the send mail part under the Mail Control section or on your dashboard click on send mail so that you can set a target audience, select the message type and select an SMS gateway type.

Here is a breakdown of the Email Control components: **4a. Send Email** ***(i). Set Target Audience*** Choose your recipients from various options, including sending to a single person, a group audience, or importing contacts from a csv or excel file.

**(*****1*****). Single Audience** Send an email message to a single person by filling their email address in the single input

**(*****2*****). Group Audience** Send an email to a group of emails that you have created in the Mail Phonebook section.

**(*****3*****). Import File** Import a file with emails then send a message to those emails. Examples of files are a like an excel sheet with emails that you want to send an email to. There is a sample of files that you can download.

***(ii).***** Write Message** ***(1)*****. Email** Compose your email effortlessly using the provided form. Craft a compelling subject line for your email to capture the attention of your recipients and encourage them to open and read your message. Specify the sender's email address from which the email will be sent. This optional field allows you to personalize the sender information for enhanced credibility and recognition. Provide a reply-to email address where recipients can respond to your message. This ensures that any replies are directed to the appropriate inbox for timely follow-up and communication.

***(2).***** Email Editing tools.** Enhance your email content using a range of editing tools tailored to suit your preferences. Whether you're formatting text, adding images, or incorporating hyperlinks, these tools empower you to create visually appealing and engaging emails that resonate with your audience.

***(3).***** Templates.** Choose from a selection of pre-designed templates to streamline your message creation process. Templates offer convenience and consistency, enabling you to craft professional messages efficiently. Once you've finalized your email content, options, and preferences, simply click the submit button to dispatch your email to the selected audience.

***(iii). Schedule and message*** Plan your email communications effectively by scheduling messages to be sent at a later date and time. Click on the calendar icon to choose the date when you want your message to be sent. A calendar will be displayed, allowing you to select the desired date and time for your message to be sent.

***(iv).***** Gateway Selection** Choose from multiple gateways for sending your email messages, allowing you to optimize delivery rates and costs. Click on the dropdown arrow next to the Gateway Selection field. This action will prompt a list to appear, displaying all the available gateway options.

**4b. Message History** View a detailed history of all emails messages sent from your account. This includes information such as subject, recipients, delivery status, and timestamps. You can view the sent email by clicking the screen icon under the action column.

**4c. Campaigns** Create, manage, and track campaigns efficiently, enhancing targeted and strategic messaging. Click on the “Add New“ button to add a campaign. You will required to enter your campaign name, the target audience , the type of message you want to send and also select the gateway type that you want to use. You can also schedule when to send the campaign. Click on the calendar icon to choose the date when you want your message to be sent. A calendar will be displayed, allowing you to select the desired date and time for your message to be sent. You can also set how often you want to repeat the campaign and select when to repeat the campaign. After that submit your campaign.

**5. Manage Templates** Create and edit templates for your messages. Templates allow you to streamline your messaging process by providing pre-defined content that you can easily reuse for your SMS and email communications. **5a. *****SMS Templates*** Create and manage templates specifically for your SMS messages. To add a new SMS template, click the " **+**" button .

You will be required to enter the name and message of the new template.

Submit the new template. Your templates will be listed on the SMS Templates. You can update templates using the pen icon or even delete it by clicking the trash icon .

**5b. Email Templates** Create and manage templates for your email communications. Email templates allow you to save time and ensure consistency in your messaging by providing pre-defined content for your emails. To create a new email template, click the " Create Template" button.

You will be prompted to enter the name of the template and to select a provider. The provider can either be Bee Pro or Texteditor .

For the Bee Pro you can choose from the available templates which you can customize to meet your needs.

The Texteditor template you can add html code that you have to create your template.

Save the new template. Your templates will be listed on the Email Templates. You can update templates using the pen icon or even delete it by clicking the trash icon . **6. SMS Phonebooks** Manage your contacts and groups for sending SMS messages. Organize your contacts efficiently and create groups to streamline your messaging process. **6a. *****Groups*** You can create and organize groups for your contacts. Groups allow you to categorize your contacts for easier management and targeted messaging. To create a new group, click the " **+**" button . Your existing groups will be listed here for easy access and organization.

You will be prompted to add the name of the group and to select the status of the group whether it is active or inactive.

Submit the group. Your groups will be listed under groups of contact. You can update an email using the pen icon or even delete it by clicking the trash icon . **6b. *****Contacts*** Manage your individual contacts here. You can add contacts manually, import contacts from a file, or export your contacts for backup or sharing purposes. ***(i). Add Contact*** To add new contact, click one the “ Add New Contact“ button.

You will be required to provide the contact number, the name, group which the contact belongs to and the status of the contact.

Submit the contact. Your contacts are listed under Select SMS Contact Options. You can update an email using the pen icon or even delete it by clicking the trash icon . ***(ii). Import Contact*** Import contacts from a file to quickly add multiple contacts at once. Click the “ Import Contact“ button to import either a csv or excel file.

You will be prompted to select the name of the group the contacts will belong to and then required to choose a file which should either be a csv or an excel file that has your contacts.

Submit the contacts and check them under Select SMS Contact Options. ***(iii). Export Contact*** Export your contacts to a file for backup or sharing. Click the “ Export Contact“ button to import either a csv or excel file.

**7. Mail Phonebooks** Manage your contacts and groups for sending email messages. Organize your contacts efficiently and create groups to streamline your email communication process. **7a. *****Groups*** You can create and organize groups for your emails. Groups allow you to categorize your contacts for easier management and targeted messaging. To create a new group, click the " **+**" button . Your existing groups will be listed here for easy access and organization.

You will be prompted to add the name of the group and to select the status of the group whether it is active or inactive.

Submit the group. Your groups will be listed under groups of contact. **7b. *****Mail*** Manage your individual contacts here. You can add contacts manually, import contacts from a file, or export your contacts for backup or sharing purposes. ***(i). Add Contact*** To add new contact, click one the “ **Add New Contact**“ button.

You will need to provide the email, the name, group which the email belongs to and the status of the contact.

You will be prompted to select the name of the group the contacts will belong to and then required to choose a file which should either be a csv or an excel file that has your contacts.

**8. Gateway Setting** Within this section, you can manage the gateways for both SMS and Email messaging. Gateways play a crucial role in facilitating the delivery of your messages, ensuring reliability and efficiency in communication. **8a. *****SMS Gateway*** Here you can configure and manage the gateways for sending SMS messages. You can set up either an API Gateway or an Android Gateway as your default gateway. Each gateway may offer unique features and capabilities to suit your messaging requirements. To add an SMS gateway, click on the "+" button at the bottom-right corner of the Gateway Method page.

You will be required to fill the fields that have a star "**\***" on them. A unique thing here is that you can fill in your own Sender ID for brand recognition and legitimacy.

**8b. *****Email Gateway*** Manage your email gateways here for sending email messages. Select the email gateways that best align with your email delivery needs, whether you prioritize deliverability, speed, or other factors. Configuring your email gateways effectively ensures reliable and efficient email communication with your audience. To add an email gateway, click the " **+**" button at the bottom-right corner of the email gateway page.

Select the gateway type of your own preference. There are several gateway types that we have including SMTP, SendGrid, AWS, Mailjet and Mailgun. You will be required to fill the fields that have a star "**\***" on them.

Submit the new gateway. Your gateways will be listed under email gateway list. You can view the information about a gateway by clicking the information icon , update a gateway using the pen icon or even delete it by clicking the trash icon .

**9. Transaction Logs** Transaction Logs section is where you can view detailed records of your transactions. Transaction logs provide transparency and accountability by documenting each transaction, including essential details such as the date of transaction, transaction number, amount, and additional information related to the transaction.

**10. Payment History** Payment History section, where you can track and review your past payments. Your payment history provides a comprehensive record of all transactions made, including essential details such as the date of payment, transaction number, amount, status, and available actions.

**11. Credit Logs** In this section, you can track the usage of your credits for both email and SMS messaging. Your credit logs provide detailed records of credit usage, including essential details such as the transaction number, credit used, post-credits (remaining credits), date, and additional transaction details. **11a. *****SMS***** Credit Logs** Track your credit usage for SMS messaging. Keep an eye on the usage and availability of credits for sending SMS messages.

**11b. *****Email***** Credit Logs** View your credit usage history for email messaging. Monitor the allocation and consumption of credits for your email communications

**12. Support Tickets** In the Support Tickets section, you'll find comprehensive details for each inquiry, including the timestamp, ticket number, subject, priority level, current status, and available actions. This allows for efficient management and resolution of all support-related matters.

To add a ticket, click the " **+**" button at the bottom-right corner of the support ticket page.

You will find a support ticket form where you will be required to write the subject of the ticket, select the priority of the ticket, describe the ticket and you can also upload a file that has your ticket.

Submit the ticket. You can view see your tickets under support tickets. Using the screen icon on each ticket, you view any of your tickets .

When you view the ticket, you will see a form where you can reply to admin or close the ticket.

**13. Generate API Key** Generate an API key for seamless integration with our platform's API services. Simply click the "**Generate API Key**" button, and a unique API key will be generated instantly. The generated key will be displayed in the form. Use the "**Copy** " button to quickly copy the key to your clipboard for easy access during integration.

**14. API Documentation** Explore our comprehensive API documentation to integrate seamlessly with our platform's email and SMS functionalities. Gain access to endpoints for sending and receiving both emails and SMS messages. Leverage our APIs to automate your communication workflows and enhance your user experience. To view the detailed documentation for each endpoint including request and response formats , click on the plus icon " **+**" .

**14a. Email** ***(i). Send Email*** Use this endpoint to send emails programmatically. Include subject, email, message content, sender name, and other relevant parameters to customize your email communications.

***(ii). Receive Email*** Receive incoming emails directly through our platform. The response will include relevant email metadata such as recipient email, content, status, and the latest update time.

**14b. SMS** ***(i). Send SMS Message*** Send SMS messages programmatically using this endpoint. Specify the message content, recipient phone numbers, and optional parameters to tailor your SMS communications.

***(ii). Receive SMS Message*** Receive incoming SMS messages through our platform. The response will include status, recipient number, message content, and the last update timestamp.